Agent Skills
› webiny/webiny-js
webiny/webiny-js
GitHub通过连续提问深度挖掘用户计划或设计，逐分支厘清依赖并给出建议，直至达成共识。适用于压力测试方案、审查设计决策或主动要求‘grill me’的场景。
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’的场景。
用户希望压力测试计划
用户要求审查设计决策
用户提及 '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检查、构建及测试等步骤，确保包可发布。
准备发布Webiny包之前
执行完整的发布前质量检查流程
npx skills add webiny/webiny-js --skill preflight -g -y
指导如何运行单包测试，区分DDB与OpenSearch环境。根据ci.config.json配置选择yarn test或yarn test:os命令，并提供更新列表的方法。
需要运行特定包的单元测试时
不确定某包应使用哪种测试命令时
npx skills add webiny/webiny-js --skill tester -g -y
辅助用户撰写产品需求文档（PRD）。通过访谈、代码库探索及模块设计，生成包含问题陈述、解决方案、用户故事等内容的结构化文档，并提交为 GitHub Issue。
用户想要编写 PRD
创建产品需求文档
规划新功能
npx skills add webiny/webiny-js --skill write-a-prd -g -y
指导在 Webiny 系统中添加新功能标志，涵盖 DTO 类型、已知标志联合、toDto 方法、Zod 验证及许可证装饰器模式，实现配置与权限的门控逻辑。
需要新增功能开关
配置功能门控逻辑
集成许可证检查
npx skills add webiny/webiny-js --skill webiny-add-feature-flag -g -y
提供 Webiny 后台扩展的架构规范，涵盖无头功能与展示功能的分层模式、目录结构及 DI 容器使用。
构建 Webiny 管理后台前端功能
设计后台扩展的目录与模块结构
实现基于 MobX 和 React 的 UI 组件
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
用于在 Webiny Admin UI 中注册和管理权限控制，支持基于 Schema 的自动表单生成、依赖注入检查及类型化 Hook，适用于单实体或多实体复杂权限场景。
需要在 Admin 界面添加权限控制逻辑
定义或修改权限 Schema 结构
集成可注入的权限检查组件或 Hook
npx skills add webiny/webiny-js --skill webiny-admin-permissions -g -y
Webiny表单模型技能，用于通过构建器API定义字段、布局、验证及动态规则。支持条件可见性、计算字段和动态区域，帮助开发者快速声明式构建复杂表单结构。
需要定义表单字段及其类型
构建表单布局与渲染器
配置表单验证逻辑
实现条件显示或禁用规则
npx skills add webiny/webiny-js --skill webiny-form-model -g -y
指导如何在Headless CMS中构建新条目向导，拦截创建流程以收集初始值并预填表单。涵盖组件注册、DI抽象定义及Feature集成等核心开发实现步骤。
需要为CMS内容模型添加自定义的创建前向导UI
希望在进入主编辑器前收集标题或分类等前置字段
集成Webiny Admin扩展以实现新的EntryWizard流程
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于在 Webiny 网站构建器中扩展页面设置，支持添加新选项卡或修改现有组。通过实现接口注册功能，将自定义数据存储于 doc.extensions 而非系统属性，确保数据隔离与系统稳定性。
需要为页面设置添加新的自定义选项卡
需要向现有的页面设置组中添加字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
用于在 Webiny Website Builder 中注入自定义查询参数到预览 URL，支持同步/异步修改，涵盖实现、注册及配置全流程。
需要向预览 URL 添加签名令牌或租户标识符
通过 Webiny 项目扩展点定制编辑器预览链接
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
用于配置 Webiny API Lambda 构建包的大小限制，解决超出默认 4.5MB 限制的构建失败问题或强制更严格限制。
API Lambda 构建包超过 4.5 MB 导致构建失败
需要调整 API 构建包的体积限制
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny后端API架构核心技能，涵盖特性创建、依赖注入、服务与用例设计及命名规范。指导扩展和核心开发中的垂直切片架构实现及反模式规避。
需要设计或重构Webiny后端API架构
询问Service与UseCase的区别及使用场景
了解createFeature注册流程及DI容器配置
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
指导在 Webiny CMS 中创建自定义批量操作，实现后台任务处理逻辑及 Admin UI 触发按钮，涵盖数据加载、处理、收敛机制及状态管理。
需要为内容条目添加批量处理功能
配置 Webiny 后台任务的 loadData 和 processData 方法
解决批量任务重复处理导致的收敛问题
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何为Webiny CMS实现自定义字段类型，涵盖扩展DataFieldBuilder、创建工厂类、DI注册及TypeScript模块增强，以支持自定义存储格式和验证逻辑。
需要Webiny CMS不支持的自定义字段类型
扩展CMS模型构建器API
实现自定义字段验证或存储格式
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
Webiny EventHandler实现规范，指导如何定义、发布及响应领域事件。强调Handler作为薄编排层，业务逻辑需封装在可复用抽象中，支持DI和事件过滤。
需要实现Webiny生命周期钩子（如Before/After）
需要定义和发布自定义领域事件
处理事件驱动的业务逻辑架构
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 框架中通过实现 Route.Interface 注册自定义 HTTP 路由，支持 GET/POST 等方法及依赖注入。
需要添加自定义 HTTP 端点
实现 Route.Interface
配置 API Gateway 路由
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 的实现模式，涵盖依赖注入、Result 错误处理、自定义错误类型及注册覆盖方法。用于构建和扩展业务逻辑单元。
实现新的 UseCase
覆盖默认 UseCase 逻辑
定义领域特定错误
配置 UseCase 依赖注入
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供Webiny v5到v6的迁移模式，指导AI代理将插件架构转换为基于DI的功能模块，包括Context转服务、事件订阅转EventHandler等核心重构步骤。
迁移Webiny v5代码至v6
转换Context插件为DI服务
适配v5事件订阅至v6 EventHandler
npx skills add webiny/webiny-js --skill webiny-v5-to-v6-migration -g -y
实现 API 到 Admin 端的 WebSocket 实时通知，用于推送后台任务进度并触发 UI 更新或提示。
需要在服务端向客户端推送实时消息
需要处理 WebSocket 事件以更新前端状态
npx skills add webiny/webiny-js --skill webiny-websocket-notifications -g -y
通过 CliCommandFactory 为 Webiny CLI 添加自定义命令，支持数据迁移、代码生成及部署脚本等扩展功能。
创建自定义 CLI 命令
编写数据迁移脚本
构建代码生成器
添加健康检查命令
npx skills add webiny/webiny-js --skill webiny-cli-extensions -g -y
指导在 Webiny 项目中集成 Auth0 身份提供商，包括安装依赖、配置 JWT 映射、设置环境变量及部署流程。
配置 Auth0 SSO
替换 Cognito
设置 OIDC 认证
JWT Claims 映射
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在 Webiny 项目中配置 Microsoft Entra ID (Azure AD) 作为联合身份提供商，通过 Cognito Federation 实现 OIDC 登录集成。
配置 Microsoft Entra ID
设置 Azure AD SSO
Webiny OIDC 集成
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
配置 Webiny 项目使用 Okta 作为身份提供商，实现 SSO、OIDC 认证及 JWT 映射。
Okta SSO 集成
替换 Cognito 为 Okta
配置 OIDC 认证
JWT Claims 映射
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
提供 Webiny 框架统一的依赖注入模式，指导如何定义实现类、声明构造函数依赖及导出服务。适用于 API、Admin、CLI 等扩展开发中理解 DI 容器、类型安全及服务访问。
编写 Webiny 扩展时
需要理解或实现依赖注入
配置构造函数参数与 dependencies 数组
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的32个抽象接口定义，涵盖文件夹及权限管理的用例和事件处理器，辅助开发者正确导入和使用核心业务逻辑。
需要调用或实现文件夹管理功能
查找API抽象类或接口的具体签名
集成Webiny后端服务逻辑
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
提供无头CMS API中内容条目、模型及分组的137个抽象定义，涵盖事件处理与用例模式。指导开发者查找并导入特定类型接口以构建CMS功能。
需要实现Headless CMS的内容管理功能
查询CmsEntry相关API接口定义
集成OpenSearch搜索过滤逻辑
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
Webiny文件管理API的48个抽象定义，涵盖资产交付、授权、读取及处理等核心接口与类型。指导开发者通过导入路径使用这些抽象，实现文件管理功能。
需要实现文件上传或下载功能
查找文件管理相关的API接口定义
集成Webiny文件管理服务
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供 Webiny API Scheduler 模块的 15 个抽象接口文档，涵盖定时任务的调度、执行、取消、查询及类型定义，辅助开发者快速集成和使用定时任务功能。
需要调用或实现定时任务相关功能
查询 Scheduler 模块的 API 接口和类型定义
npx skills add webiny/webiny-js --skill webiny-api-scheduler-catalog -g -y
提供 Webiny API 安全与认证模块的 53 个抽象定义，涵盖身份验证、API 密钥、角色、用户及团队的事件处理器和用例，用于实现安全相关的业务逻辑。
需要实现自定义身份验证流程
管理 API 密钥生命周期
处理用户或团队相关的安全事件
npx skills add webiny/webiny-js --skill webiny-api-security-catalog -g -y
提供 Webiny API 系统安装相关的抽象类与事件处理器，用于执行系统级安装流程及监听安装完成事件。
需要初始化或安装 Webiny 系统环境
需要监听或处理系统安装完成后的生命周期事件
npx skills add webiny/webiny-js --skill webiny-api-system-catalog -g -y
提供多租户API的17个抽象接口，涵盖租户生命周期管理（创建、删除、更新）及应用安装事件处理。用于实现基于租户的业务逻辑和数据隔离。
需要创建、删除或查询租户信息
实现租户应用安装或卸载逻辑
编写租户生命周期事件处理器
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供租户管理相关的API抽象与用例，涵盖创建、更新、启用、禁用及查询租户等功能，支持扩展租户模型，辅助开发者实现多租户业务逻辑。
需要创建或管理租户
实现多租户隔离逻辑
查询租户状态
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
提供网站构建器中页面和重定向管理的API抽象，涵盖创建、删除、获取、复制页面及重定向等用例。用于指导开发者集成Webiny CMS的内容管理功能。
需要实现页面或重定向的增删改查功能
查询Webiny网站构建器的API接口定义
npx skills add webiny/webiny-js --skill webiny-api-website-builder-catalog -g -y
提供Webiny基础设施的35种抽象扩展，涵盖Admin和API模块的构建、部署及监听钩子，以及Pulumi集成。用于标准化和管理云基础设施生命周期中的关键事件与配置。
需要配置或自定义基础设施构建流程
需要处理部署前后的钩子逻辑
涉及Pulumi IaC管理
npx skills add webiny/webiny-js --skill webiny-infra-catalog -g -y
用于通过Pulumi和声明式组件自定义AWS基础设施，支持配置VPC、OpenSearch、蓝绿部署及环境条件设置。
需要修改或扩展AWS云资源配置时
配置基础设施的声明式参数如区域、标签、域名时
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
Webiny本地开发与部署技能，涵盖环境管理、本地Lambda调试及多应用构建。
本地开发调试
部署命令执行
环境管理
npx skills add webiny/webiny-js --skill webiny-local-development -g -y
用于在 Webiny 项目中配置 SMTP 邮件发送服务。通过在 webiny.config.tsx 中添加 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 配置及扩展注册机制，指导开发者理解目录布局与代码组织方式。
询问 Webiny 项目文件夹结构
了解 webiny.config.tsx 的作用
查询自定义代码存放位置
学习如何注册扩展
npx skills add webiny/webiny-js --skill webiny-project-structure -g -y
用于生成、更新和维护 Webiny MCP 服务器技能库的元技能，支持从源码文档创建新技能或批量刷新整个技能集。
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，包括白标化（品牌、主题）、添加内容列表自定义列、创建页面类型表单及扩展 Lexical 编辑器。
需要修改管理后台的品牌标识或主题颜色
需要在内容列表中添加自定义数据列
需要为网站构建器创建自定义表单
需要注册命名对话框或抽屉组件
需要扩展富文本编辑器功能
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
通过调用AI Power Ups扩展，以编程方式生成或重写Headless CMS条目内容。适用于批量操作、生命周期钩子等场景，自动应用用户配置的模型和提示词，无需直接处理LLM细节。
需要程序化生成CMS内容
在后台任务中调用AI生成摘要
使用配置好的AI模型重写文本
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置 Webiny 项目的 Cognito 联邦身份认证，支持 Google、OIDC 等外部提供商登录。涵盖基础设施搭建、管理员登录界面定制及 API 身份映射同步。
配置 Cognito 联邦登录
添加外部身份提供商（如 Google、Entra ID）
自定义 Cognito 登录界面
处理 OIDC/OAuth 重定向与用户同步
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
通过代码定义无头CMS内容模型，涵盖字段、验证器、布局及API查询语法。
创建或修改CMS内容模型
配置字段类型与验证规则
设置Admin UI渲染器
处理SDK查询投影语法
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供Webiny ACO模块的前端抽象，包括useNavigateFolder和useRecords钩子，用于管理文件夹导航和记录数据。
需要实现文件夹导航功能
需要获取和管理ACO记录数据
npx skills add webiny/webiny-js --skill webiny-admin-aco-catalog -g -y
提供Webiny管理后台AI功能模块的抽象接口，如获取设置功能。引导开发者通过导入路径使用具体特性，强调需阅读源码以获取准确类型和接口定义。
需要集成Webiny管理后台的AI设置功能
查找Webiny AI Powerups的具体实现接口
npx skills add webiny/webiny-js --skill webiny-admin-ai-powerups-catalog -g -y
