Agent Skills
› webiny/webiny-js
webiny/webiny-js
GitHub通过 relentless 提问压力测试用户计划或设计，逐步厘清决策树分支与依赖，提供推荐答案，支持代码库探索以辅助回答。
安装全部 Skills
npx skills add webiny/webiny-js --all -g -y
集合内 Skills (85)
按质量分展示前 50 个（共 85 个），完整列表请用安装命令预览或逐个打开详情。
通过 relentless 提问压力测试用户计划或设计，逐步厘清决策树分支与依赖，提供推荐答案，支持代码库探索以辅助回答。
用户希望压力测试计划
用户要求对设计进行严格质询
用户提到 'grill me'
npx skills add webiny/webiny-js --skill grill-me -g -y
将产品需求文档（PRD）拆解为多阶段实施计划，采用垂直切片方法。需确认PRD、探索代码库、识别架构决策并生成可演示的细粒度阶段，最终输出为Markdown文件。
用户希望从PRD创建实施计划
用户提到使用追踪子弹（tracer bullets）进行规划
npx skills add webiny/webiny-js --skill prd-to-plan -g -y
用于 Webiny 项目发布前的预检流程，依次执行依赖安装、版本同步、代码格式化、Lint 检查、构建及测试等步骤，确保包状态就绪。
准备发布 Webiny 包之前
需要验证代码质量和构建完整性时
npx skills add webiny/webiny-js --skill preflight -g -y
指导如何运行测试，包括针对单个包的DDB和OpenSearch测试命令。根据包在ci.config.json中的storageOps配置，自动判断应使用yarn test、yarn test:os还是两者结合，并提供更新列表的方法。
需要运行项目测试时
询问如何执行特定包的测试
npx skills add webiny/webiny-js --skill tester -g -y
通过用户访谈、代码库探索和模块设计，协助创建详细的产品需求文档（PRD），并输出为Markdown文件及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 管理后台扩展的架构规范，涵盖无头功能（UseCase/Repository/Gateway）与展示层（MobX Presenter/hooks/components）的开发模式、目录结构及上下文适配。
构建 Webiny Admin 扩展
实现前端功能模块
配置 React 组件与状态管理
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
用于在 Webiny 管理后台注册权限 UI 及实现依赖注入权限检查。涵盖基于 Schema 的自动表单生成、可注入权限检查、Typed Hooks 及组件使用，支持简单应用到复杂多实体权限体系。
添加管理员界面权限控制
定义权限 Schema
集成依赖注入权限检查
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中构建新条目向导，拦截创建流程以收集初始值并预填表单。涉及React组件、DI注入及Webiny插件注册机制。
需要为CMS内容创建添加前置引导步骤
实现自定义的条目创建向导UI
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于在 Webiny 网站构建器中扩展页面设置，支持添加新选项卡或修改现有组。通过实现特定接口并注册功能来定制 UI 和数据存储，强调数据应存入 doc.extensions 而非系统属性。
需要为页面设置添加新的自定义选项卡
需要向现有的页面设置组注入额外字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
提供Webiny网站构建器中PreviewUrlModifier扩展点的实现与注册指南，用于向预览URL注入自定义查询参数（如Token、租户标识），支持同步/异步修改及特性注册。
用户需要向预览URL添加自定义查询参数
用户需要在预览链接中注入签名令牌或功能标志
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
配置 Webiny API Lambda 包大小限制。当构建产物超过默认 4.5MB 或需收紧限制时，通过修改 webiny.config.tsx 中的 Infra.Api.MaxBundleSize 扩展来调整上限，解决构建失败问题。
API Lambda 构建报错 bundle size exceeds limit
需要自定义调整 API 包大小限制
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny后端API架构指南，涵盖DI容器注册、特性模块结构、Service与UseCase设计模式、命名规范及反模式。适用于扩展和核心开发，提供从入口到依赖注入的完整后端开发规范。
需要设计或重构后端API功能
询问Webiny框架中的服务注册或依赖注入规则
确定Service与UseCase的职责边界
遵循后端代码规范和命名约定
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
指导在 Webiny Headless CMS 中开发自定义批量操作，实现 EntriesBulkAction 接口以处理后台任务及 Admin UI 集成。
需要为内容条目添加批量处理逻辑
配置 Webiny 后台任务的 loadData 和 processData
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何为 Webiny CMS 实现自定义字段类型，涵盖扩展 DataFieldBuilder、工厂类创建、DI 注册及 TypeScript 模块增强，以支持新存储格式和验证逻辑。
需要自定义 CMS 字段类型
扩展模型构建器 API
添加新的字段验证规则
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
Webiny EventHandler 实现模式，用于处理生命周期事件、定义领域事件及发布逻辑。强调将业务逻辑封装在可复用抽象中，Handler仅作为薄编排层，支持依赖注入和事件过滤。
需要实现 Webiny 事件处理器
定义并发布自定义领域事件
重构事件处理逻辑以分离关注点
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 Gateway 中注册自定义 HTTP 路由，支持 GET/POST 等方法及依赖注入。
需要添加自定义 HTTP 端点
实现 Route.Interface 并注册到 webiny.config.tsx
npx skills add webiny/webiny-js --skill webiny-http-route -g -y
定义基于Schema的API权限系统，涵盖权限模式创建、DI抽象注入、读写删除发布权限检查及记录范围控制，实现从定义到测试的全流程授权管理。
实现用例中的身份验证和授权逻辑
定义或修改权限Schema结构
集成可注入的权限抽象到业务代码
编写权限相关的单元测试矩阵
npx skills add webiny/webiny-js --skill webiny-api-permissions -g -y
Webiny框架中UseCase实现模式的指南，涵盖DI注入、Result错误处理、自定义实现覆盖及CMS数据持久化。用于指导开发者构建和扩展业务逻辑单元。
需要实现新的业务用例
覆盖默认UseCase逻辑
处理API层错误与结果
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供Webiny v5到v6架构迁移模式，指导AI代理将插件系统转换为基于DI的服务和EventHandler，实现代码平滑升级。
需要将Webiny v5插件迁移至v6架构
理解v5与v6设计模式的差异
npx skills add webiny/webiny-js --skill webiny-v5-to-v6-migration -g -y
提供在 Webiny 框架中通过 WebSocket 实现 API 到 Admin 端实时通知的功能，支持服务端推送消息并在客户端响应展示。
需要在后台任务或操作完成后向用户发送实时进度通知
需要在前端根据后端事件动态更新 UI 或显示提示
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 声明到 Webiny 身份
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在Webiny项目中配置Microsoft Entra ID作为联合身份提供商，通过Cognito Federation实现微软SSO登录。
配置 Microsoft Entra ID
设置 Azure AD SSO
集成 Microsoft OIDC
配置 Webiny 微软登录
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
指导在Webiny项目中配置Okta作为外部身份提供商，替代默认Cognito。涵盖安装包、创建API配置类映射JWT声明、注册React扩展组件及设置环境变量，实现SSO和自定义登录流程。
配置Okta认证
替换Cognito为Okta
设置OIDC认证
映射JWT声明到用户身份
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
掌握Webiny框架通用的依赖注入模式，涵盖构造器注入、dependencies数组配置及Logger/BuildParams等服务访问。适用于API、Admin、CLI和Infrastructure扩展开发，确保类型安全与编译时验证。
编写Webiny扩展代码
实现服务类并声明依赖
解决依赖注入相关错误
npx skills add webiny/webiny-js --skill webiny-dependency-injection -g -y
提供Webiny全栈扩展的骨架结构与注册模式，整合API与Admin入口及共享领域层，指导开发人员在extensions或packages中正确构建和注册全栈功能模块。
创建同时包含API和Admin功能的Webiny扩展
配置全栈扩展的顶层组件与入口点注册
npx skills add webiny/webiny-js --skill webiny-full-stack-architect -g -y
提供 Webiny ACO 模块的 API 抽象参考，涵盖文件夹及权限管理的 UseCase、Repository 和 EventHandler。辅助开发者快速定位接口并实现业务逻辑。
需要创建或删除文件夹
管理文件夹级权限
处理文件夹生命周期事件
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
提供无头CMS的API抽象，涵盖内容条目、模型及分组的事件处理器和使用案例。支持OpenSearch全文搜索、过滤和排序等高级功能，辅助开发者集成和扩展CMS能力。
需要实现或扩展Headless CMS的内容管理逻辑
配置或自定义OpenSearch搜索行为与索引策略
开发CMS相关的后端事件处理或使用案例
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
Webiny文件管理器API抽象层参考，提供资产交付相关的事件处理器和使用案例接口定义，辅助开发者实现文件管理功能。
需要实现文件上传或下载功能
查找文件资产管理相关的接口和类型
开发Webiny插件或自定义处理逻辑
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供Webiny API调度器的15个抽象接口文档，涵盖计划任务的创建、执行、取消、查询及类型定义，辅助开发者快速集成定时任务功能。
需要实现定时任务或延迟执行逻辑
查询或导入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 系统安装相关的抽象，包括 InstallSystemUseCase 和 SystemInstalledEventHandler，用于执行系统级安装及监听安装完成事件。
需要运行系统安装流程
需要处理系统安装完成后的生命周期钩子
npx skills add webiny/webiny-js --skill webiny-api-system-catalog -g -y
提供多租户生命周期管理的API抽象，涵盖租户的创建、删除、查询及安装等用例，并包含前置和后置事件处理器，用于实现完整的租户管理功能。
需要创建或删除租户
实现多租户应用的事件监听
集成租户安装逻辑
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供 Webiny 租户管理 API 的 9 个核心抽象，涵盖租户创建、启用、禁用、更新及查询等用例实现指南。
需要创建或管理多租户系统中的租户实例
查询或修改租户配置与状态
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
提供 Webiny 网站构建器中页面和重定向相关的 API 抽象与用例，支持页面的创建、删除、获取及版本管理，以及 URL 重定向的 CRUD 操作。
需要实现网站页面管理功能
需要配置或管理 URL 重定向规则
npx skills add webiny/webiny-js --skill webiny-api-website-builder-catalog -g -y
提供Webiny基础设施扩展抽象，涵盖Admin和Api模块的构建、部署及监听生命周期钩子，以及Pulumi堆栈输出服务。
配置基础设施构建或部署流程
集成Pulumi管理云资源堆栈
npx skills add webiny/webiny-js --skill webiny-infra-catalog -g -y
用于通过Pulumi和声明式组件自定义AWS基础设施，支持配置VPC、OpenSearch、标签、区域、域名及蓝绿部署等。
自定义AWS基础设施资源
配置Pulumi处理程序
设置OpenSearch或VPC
管理蓝绿部署
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
提供Webiny项目的本地开发与部署指南，涵盖多环境管理、API/Admin的Watch模式调试及Lambda模拟机制。
询问Webiny本地开发配置
执行部署或销毁命令
排查Lambda本地运行问题
npx skills add webiny/webiny-js --skill webiny-local-development -g -y
用于在 Webiny 项目中配置 SMTP 邮件发送功能，指导用户通过 Api.Mailer.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 项目目录结构
查询 webiny.config.tsx 配置含义
了解如何注册 API/Admin/Infra/CLI 扩展
确定自定义代码存放位置
npx skills add webiny/webiny-js --skill webiny-project-structure -g -y
用于生成、更新和维护 Webiny MCP Server 的技能库。支持全量再生或单技能创建，依据源码和文档自动构建 SKILL.md 文件，确保代码示例完整及依赖路径准确。
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 编辑器。
需要修改管理后台品牌标识或主题颜色
需要在内容列表中添加自定义列
需要为网站构建器创建自定义表单
需要注册对话框或抽屉组件
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
提供在 Webiny Headless CMS 中通过 AI Power Ups 扩展程序生成、摘要或重写条目内容的技能，支持在代码中调用以应用用户配置的 AI 提供商和角色设定。
需要在后台任务或生命周期钩子中自动生成 CMS 内容
需要基于用户配置的项目或人设进行内容摘要/重写
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置 Webiny 项目的 Cognito 联合身份认证，支持 Google、Apple 等外部 IdP。涵盖基础设施 OAuth 设置、管理员登录界面定制及 API 用户同步逻辑。
询问如何添加外部身份提供商（如 Google、Microsoft）登录
需要配置 Cognito 联合身份或 SSO
自定义 Cognito 登录界面或用户同步逻辑
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
指导通过代码定义无头CMS内容模型，涵盖字段、验证、布局及查询投影语法。
创建或修改CMS内容模型
配置字段类型与验证规则
解决SDK查询中的嵌套字段投影问题
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供 Webiny Admin ACO 模块的两个核心抽象：useNavigateFolder 用于文件夹导航，useRecords 用于记录管理。通过导入指定路径使用，需查阅源码获取详细接口和类型定义。
需要实现后台管理系统的文件夹导航功能
需要在前端组件中管理和展示 ACO 记录数据
npx skills add webiny/webiny-js --skill webiny-admin-aco-catalog -g -y
提供Webiny管理后台AI增强功能的抽象接口，引导开发者查找并导入特定功能模块，强调阅读源码以获取准确类型和接口定义。
需要集成Webiny AI管理功能
查询admin/ai-powerups模块可用抽象
npx skills add webiny/webiny-js --skill webiny-admin-ai-powerups-catalog -g -y
