Agent Skills
› webiny/webiny-js
webiny/webiny-js
GitHub通过持续追问和压力测试，帮助用户深入梳理计划或设计中的决策分支，消除歧义并达成共同理解。
Install All Skills
npx skills add webiny/webiny-js --all -g -y
Skills in Collection (85)
Showing top 50 of 85 by quality score. Use the install list command or open individual skills for the rest.
通过持续追问和压力测试，帮助用户深入梳理计划或设计中的决策分支，消除歧义并达成共同理解。
用户希望压力测试计划
用户要求对设计进行严苛审查
用户提到 'grill me'
npx skills add webiny/webiny-js --skill grill-me -g -y
将产品需求文档分解为基于垂直切片的多阶段实施计划，输出为本地 Markdown 文件。通过识别持久化架构决策、划分端到端功能模块并与用户确认粒度，最终生成结构化的开发规划文档。
用户希望分解 PRD
创建实施计划
从 PRD 规划阶段
提及 tracer bullets
npx skills add webiny/webiny-js --skill prd-to-plan -g -y
Webiny项目发布前的预检流程，依次执行依赖安装、包生成、版本同步、代码格式化与Lint检查、完整构建及测试。测试需按包顺序执行并按32个用例分片，确保代码质量和构建产物符合发布标准。
准备发布Webiny包前
需要验证包依赖和构建状态
npx skills add webiny/webiny-js --skill preflight -g -y
指导如何运行测试，区分DDB和OpenSearch场景。根据包配置决定执行yarn test或yarn test:os，并列出需双运行的包、仅OpenSearch的包及其他包的默认命令，同时提供更新列表的方法。
用户询问如何运行特定包的测试
用户需要执行OpenSearch相关测试
用户不确定应使用哪个测试命令
npx skills add webiny/webiny-js --skill tester -g -y
引导用户通过访谈和代码库探索，梳理需求与模块设计，最终生成结构化 PRD 并作为 GitHub Issue 提交。
用户希望撰写产品需求文档
需要规划新功能或解决特定问题
npx skills add webiny/webiny-js --skill write-a-prd -g -y
指导在Webiny系统中添加新功能标志，涵盖DTO类型、Zod校验及API集成步骤。
创建新功能标志
配置功能门控逻辑
npx skills add webiny/webiny-js --skill webiny-add-feature-flag -g -y
提供Webiny后台扩展的架构规范，涵盖无头功能与展示功能的分层设计、DI容器注册及React集成模式。
开发Webiny管理后台扩展
构建Admin侧前端组件
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
指导在Webiny管理后台注册权限UI及通过DI进行权限检查，涵盖Schema定义、依赖注入配置及类型安全的Hooks和组件使用。
添加管理后台权限控制
配置权限Schema
实现基于DI的权限检查
npx skills add webiny/webiny-js --skill webiny-admin-permissions -g -y
Webiny表单模型技能，用于通过声明式API定义字段、布局、验证及动态逻辑。支持文本、数字等类型，结合Zod或命令式规则进行校验，并处理条件显示、计算字段及嵌套结构。
需要构建复杂表单界面
配置表单字段类型与渲染器
实现表单数据验证规则
设置表单联动与动态逻辑
npx skills add webiny/webiny-js --skill webiny-form-model -g -y
指导在Headless CMS中构建新建条目向导，拦截创建流程以收集初始字段并预填表单。涵盖DI抽象、Feature注册及React组件实现，用于优化内容录入体验。
需要为CMS内容模型添加自定义创建向导
希望在进入主编辑器前收集标题或分类等初始数据
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于扩展网站构建器页面设置，支持添加新选项卡或修改现有组。涵盖创建自定义设置组、注入字段及数据持久化规范，确保自定义数据存储于doc.extensions而非系统属性中。
需要为页面设置添加新的自定义选项卡
需要向现有的页面设置组（如SEO、常规）中添加或修改字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
用于在 Webiny Website Builder 中通过扩展点向预览 URL 注入自定义查询参数，支持同步/异步修改及依赖注入注册。
用户需要向预览链接添加认证令牌或租户标识
用户希望动态修改页面编辑器的预览 URL 参数
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
用于配置 Webiny API Lambda 构建包的体积上限。当包大小超过默认限制导致构建失败，或需调整限制时，通过修改 webiny.config.tsx 中的 Infra.Api.MaxBundleSize 扩展项解决。
API Lambda 构建包超过 4.5MB 限制导致构建报错
需要自定义或收紧 API 构建包的体积限制
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny后端API架构指南，涵盖特性注册、DI容器、Service与UseCase设计模式、命名规范及反模式，用于指导后端开发。
需要设计或实现Webiny后端API功能
询问关于DI容器注册、Service/UseCase职责划分的问题
查找后端代码结构模板或命名约定
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
用于在 Webiny Headless CMS 中创建自定义批量操作（EntriesBulkAction），实现后台任务处理与 Admin UI 触发，涵盖数据加载、分批处理及状态收敛机制。
需要为内容条目列表添加批量操作功能
开发自定义后台批量处理逻辑
集成 Admin UI 批量操作按钮
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何在 Webiny CMS 中实现自定义字段类型，涵盖扩展 DataFieldBuilder、组合验证器、创建工厂类、通过 DI 注册及 TypeScript 模块增强，以支持 Fluent API 和自动补全。
需要实现内置类型之外的自定义 CMS 字段
为 ModelFactory 添加新的字段构建方法
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
提供 Webiny 框架中 EventHandler 的实现模式，涵盖命名规范、接口定义、依赖注入及领域事件发布。强调将业务逻辑封装为可复用抽象，Handler 仅作为薄层编排器，适用于前后钩子实现与自定义事件开发。
需要实现 Webiny 事件处理器
定义或发布领域事件
处理 CMS 或租户生命周期钩子
npx skills add webiny/webiny-js --skill webiny-event-handler-pattern -g -y
指导在 Webiny 中通过 GraphQLSchemaFactory 添加自定义 GraphQL 查询、突变及解析器，支持依赖注入与权限控制。
需要添加自定义 GraphQL 端点
创建自定义查询或突变
构建自定义解析器并注入后端服务
npx skills add webiny/webiny-js --skill webiny-custom-graphql-api -g -y
指导在Webiny框架中通过Api.Route组件注册自定义HTTP路由，实现Handler类与依赖注入。
添加自定义HTTP端点
配置API路由处理程序
npx skills add webiny/webiny-js --skill webiny-http-route -g -y
基于 Schema 的 API 权限系统，涵盖权限定义、DI 抽象注入及用例集成。支持读写删除发布操作及记录范围控制，提供从模式定义到测试矩阵的完整实现指南。
实现 API 授权逻辑
定义权限 Schema
检查用户读写删除权限
处理记录访问范围限制
npx skills add webiny/webiny-js --skill webiny-api-permissions -g -y
Webiny框架的UseCase实现模式指南，涵盖DI注入、Result错误处理、装饰器及CMS数据持久化。用于指导开发者规范地创建、注入、覆盖和扩展业务用例逻辑。
需要实现新的业务用例
配置依赖注入或覆盖默认实现
处理业务逻辑中的错误与结果类型
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供 Webiny v5 到 v6 的迁移模式，指导将插件架构转换为基于 DI 的特性架构，包括 ContextPlugin 转服务及事件订阅转 EventHandler。
Webiny 版本升级迁移
插件架构重构为依赖注入
npx skills add webiny/webiny-js --skill webiny-v5-to-v6-migration -g -y
实现Webiny平台中API向Admin端发送实时WebSocket通知的功能。支持服务端推送消息，客户端监听并触发UI更新或Toast提示，适用于后台任务进度反馈等场景。
需要在后端操作完成后实时通知前端用户
实现基于WebSocket的服务器到客户端消息推送
npx skills add webiny/webiny-js --skill webiny-websocket-notifications -g -y
指导在 Webiny CLI 中通过 CliCommandFactory 模式创建自定义命令，支持数据迁移、代码生成及部署脚本等功能。
创建自定义 CLI 命令
添加数据迁移脚本
构建代码生成器
创建部署脚本
npx skills add webiny/webiny-js --skill webiny-cli-extensions -g -y
配置Webiny项目使用Auth0作为身份提供商，替代默认Cognito。涵盖安装依赖、创建JWT映射配置类、集成React扩展组件及环境变量设置，实现OIDC认证和登录流程定制。
配置Auth0认证
替换Cognito为Auth0
设置外部身份提供商
配置OIDC认证
映射JWT Claims
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在 Webiny 项目中通过 Cognito Federation 配置 Microsoft Entra ID (Azure AD) 作为联合身份提供商，涵盖应用注册、密钥获取及 OIDC 集成步骤。
询问如何配置 Microsoft Entra ID 或 Azure AD
需要设置 Microsoft SSO 或 OIDC 登录
涉及 Webiny 与 Microsoft 365 账户连接
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
指导在Webiny项目中配置Okta作为身份提供商，替代默认Cognito。涵盖安装包、创建API配置映射JWT声明、编写React扩展组件、注册扩展及设置环境变量等步骤，实现SSO和自定义登录流程。
配置Okta认证
替换Cognito为Okta
设置OIDC身份提供商
映射JWT claims到Webiny身份
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
说明 Webiny 框架中通用的依赖注入模式，涵盖扩展与核心开发的构造函数注入、服务访问及依赖声明规则。
编写 Webiny 扩展需要理解依赖注入
使用 Logger/BuildParams/CMS 用例等可注入服务
配置 dependencies 数组或实现 *.Interface
npx skills add webiny/webiny-js --skill webiny-dependency-injection -g -y
提供全栈扩展骨架与注册模式，指导如何构建同时包含API和Admin的Webiny扩展。涵盖共享领域层、入口点声明及包结构规范，区分插件与核心开发上下文。
创建同时涉及API和Admin功能的Webiny扩展
需要配置全栈扩展的顶层组件和入口点
npx skills add webiny/webiny-js --skill webiny-full-stack-architect -g -y
提供Webiny ACO模块中文件夹及权限相关的32个抽象接口，包括UseCase、Repository和EventHandler。用于指导开发者正确导入和使用文件夹创建、删除、权限管理等核心功能的类型与实现模式。
需要实现或调用Webiny ACO中的文件夹管理功能
查询文件夹级别权限(FLP)的API抽象定义
寻找文件夹生命周期事件处理器的使用方式
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
Webiny Headless CMS API 抽象参考，提供内容条目、模型及组的事件处理器和用例接口。涵盖 OpenSearch 搜索、过滤、排序等核心功能，指导开发者导入类型并实现业务逻辑。
需要集成或扩展 Webiny Headless CMS 的 API 功能
查询 CmsEntry 或 OpenSearch 相关接口的定义与用法
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
Webiny文件管理器API的48个抽象定义，涵盖资产交付、处理及事件处理器用例。提供接口类型与导入路径指引，辅助开发者实现文件管理功能。
需要实现文件上传或下载逻辑
查找文件管理相关的TypeScript接口
集成Webiny文件管理服务
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供 Webiny API 调度器模块的抽象类与类型参考，涵盖计划任务的创建、执行、取消及查询等用例。
需要实现定时任务逻辑
查询调度器接口定义
npx skills add webiny/webiny-js --skill webiny-api-scheduler-catalog -g -y
提供 Webiny API 安全与认证模块的 53 个抽象接口参考，涵盖身份验证、API 密钥、角色及用户团队的事件处理器和使用案例。
需要实现 API 身份验证逻辑
管理 API 密钥生命周期
配置角色和用户权限
处理安全相关事件钩子
npx skills add webiny/webiny-js --skill webiny-api-security-catalog -g -y
提供 Webiny API 系统安装相关的抽象定义，包括安装用例和生命周期事件处理器，指导开发者导入并使用这些核心功能。
需要初始化或安装 Webiny 系统
监听系统安装完成事件
查找系统安装相关的 API 接口
npx skills add webiny/webiny-js --skill webiny-api-system-catalog -g -y
提供 Webiny 多租户 API 的 17 个抽象，涵盖租户生命周期管理及安装事件处理。包括创建、删除、查询租户用例及前后钩子，辅助开发者实现多租户应用集成与运维。
需要创建或删除租户
实现多租户应用安装逻辑
监听租户生命周期事件
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供多租户管理相关的API抽象与用例，涵盖租户的创建、安装、启用、禁用、更新及查询等功能，并支持租户模型扩展。
需要实现多租户系统的CRUD操作
处理租户生命周期事件如创建或禁用
扩展租户数据模型字段
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
Webiny网站构建器API技能，提供58个页面与重定向相关的事件处理器和用例抽象。涵盖页面的增删改查、版本管理及URL重定向管理，用于后端业务逻辑实现。
需要创建或管理网站页面
需要配置URL重定向规则
查询页面详情或历史版本
开发网站构建器后端功能
npx skills add webiny/webiny-js --skill webiny-api-website-builder-catalog -g -y
提供Webiny基础设施的35种抽象扩展，涵盖Admin和Api构建、部署及监听等生命周期钩子。用于定义和管理云资源堆栈及自动化流程。
配置基础设施构建或部署流程
集成Pulumi管理云资源
处理应用发布前后逻辑
npx skills add webiny/webiny-js --skill webiny-infra-catalog -g -y
通过Pulumi处理程序和声明式组件自定义AWS基础设施，支持VPC、OpenSearch、标签、域名及蓝绿部署等配置。
需要修改AWS基础设施资源
配置OpenSearch或VPC网络
设置自定义域名或SSL证书
启用蓝绿部署策略
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
指导 Webiny 项目的本地开发与部署，涵盖使用 yarn webiny deploy 进行环境管理和发布，以及通过 watch 模式在本地调试 API 和 Admin 应用。
询问 Webiny 部署命令或环境管理
配置本地开发或调试 Lambda/React 应用
npx skills add webiny/webiny-js --skill webiny-local-development -g -y
用于在 Webiny 项目中配置 SMTP 邮件发送服务，指导如何正确设置主机、端口及认证信息。
configure email
set up SMTP
mailer config
sending emails
email not working
configure mailer
SMTP password
Api.Mailer.Smtp
npx skills add webiny/webiny-js --skill webiny-mailer-smtp -g -y
说明 Webiny 项目的扁平化结构，重点介绍 webiny.config.tsx 配置文件的扩展注册机制及 extensions/ 目录的代码组织方式。
询问项目文件夹结构
解释 webiny.config.tsx 作用
了解如何注册扩展
区分不同扩展类型
npx skills add webiny/webiny-js --skill webiny-project-structure -g -y
用于根据源码和文档生成、更新及维护 Webiny MCP Server 技能库的元技能，支持全量重建或单技能创建。
create a skill
update skills
refresh skills
add a new skill for X
regenerate the skill library
npx skills add webiny/webiny-js --skill webiny-skill-creator -g -y
用于自定义 Webiny 管理后台 UI，包括品牌定制（Logo、主题色）、添加内容列表自定义列、创建页面类型表单以及扩展 Lexical 编辑器。通过 React 组件注册实现界面个性化与功能增强。
需要修改 Webiny 后台的 Logo、标题或主题颜色
需要在内容管理列表中增加自定义数据列
需要为网站构建器页面类型创建自定义表单
需要注册命名对话框或抽屉以从任意位置调用
需要扩展或修改 Lexical 富文本编辑器的行为
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
在 Webiny Headless CMS 中通过 AI Power Ups 扩展，以编程方式生成、摘要或重写 CMS 条目内容。开发者可注入用例并配置提示词及角色，自动调用用户配置的 LLM 提供商，返回生成的 JSON 数据供后续处理。
需要批量更新 CMS 内容
在生命周期钩子中自动生成字段
通过自定义 Mutation 触发 AI 内容创作
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置 Webiny 项目中通过 Cognito 实现外部身份提供商（如 Google、Apple）的联合登录，涵盖基础设施、管理后台登录界面及 API 身份映射的全流程。
配置 Cognito 联合登录
添加外部 IdP 认证
自定义管理员登录界面
处理 OAuth 重定向
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
通过代码创建和配置 Headless CMS 内容模型，涵盖字段定义、验证规则、布局及引用关系处理。
需要以编程方式定义 CMS 内容模型结构
配置字段类型、验证器或 Admin UI 渲染器
解决 SDK 查询中 ref 与 object 字段的投影语法问题
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供Webiny ACO模块的React Hooks抽象，包括useNavigateFolder和useRecords，用于管理文件夹导航和数据记录操作。
需要实现文件夹导航功能
需要获取和管理数据记录
npx skills add webiny/webiny-js --skill webiny-admin-aco-catalog -g -y
提供Webiny管理后台AI增强功能的抽象接口，如获取设置功能。帮助开发者快速集成和调用AI相关能力。
需要集成Webiny AI功能
查找AI增强模块的导入路径
npx skills add webiny/webiny-js --skill webiny-admin-ai-powerups-catalog -g -y
