Agent Skills
› webiny/webiny-js
webiny/webiny-js
GitHub通过 relentless 提问压力测试用户计划或设计，逐步厘清决策树分支与依赖，提供推荐答案，支持代码库探索以辅助回答。
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.
通过 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
