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
将产品需求文档（PRD）拆解为基于垂直切片的多阶段实施计划，通过代码库探索和识别持久架构决策，生成可验证的 Tracer Bullet 方案并输出为 Markdown 文件。
用户希望从 PRD 创建实施计划
提及使用 Tracer bullets 或垂直切片进行任务分解
npx skills add webiny/webiny-js --skill prd-to-plan -g -y
用于在发布前执行全套预检流程，包括依赖安装、版本同步、代码格式化、Lint检查、构建及测试。确保包状态就绪，防止发布错误。
准备发布包之前
CI/CD流水线触发预检
npx skills add webiny/webiny-js --skill preflight -g -y
提供运行测试的命令指南，支持单包测试。根据包配置区分仅DDB测试、仅OpenSearch测试或两者均需执行，并列出具体包列表及更新方法，确保测试覆盖正确性。
需要运行项目测试
查询特定包的测试命令
了解ddb-os测试流程
npx skills add webiny/webiny-js --skill tester -g -y
协助用户撰写产品需求文档（PRD），通过问题描述、代码库探索、深度访谈及模块设计，最终生成包含问题陈述、用户故事、实现与测试决策的完整PRD并提交为GitHub Issue。
用户想要编写PRD
创建产品需求文档
规划新功能
npx skills add webiny/webiny-js --skill write-a-prd -g -y
指导在Webiny系统中添加新功能标志，涵盖DTO类型、已知标志联合、Zod校验及API集成，确保正确配置许可证与开关逻辑。
需要新增功能开关
配置功能标志的DTO或Schema
集成许可证检查逻辑
npx skills add webiny/webiny-js --skill webiny-add-feature-flag -g -y
指导Webiny后台扩展开发，涵盖无头功能与展示功能的架构模式、目录结构及依赖注入规范。
构建Webiny管理后台扩展
实现Admin侧业务逻辑或UI组件
配置MobX Presenter或UseCase
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
提供Webiny管理后台权限控制的开发指南，涵盖基于Schema的UI自动生成、依赖注入权限检查及类型化Hooks组件的使用。
添加Admin UI权限控制
配置权限Schema
使用DI容器进行权限检查
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 中构建新建条目向导，拦截创建流程以收集初始字段并预填表单。涵盖注册、抽象定义、特性配置及视图渲染，实现带脏标记的自定义 UI 交互。
需要为 CMS 内容模型添加新建前的自定义引导流程
希望在新建条目时预先收集标题、分类等基础信息
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于扩展网站构建器的页面设置，支持添加新选项卡或修改现有组。指导实现PageSettingsGroup和Modifier接口，注册功能，并强调自定义数据必须存储于doc.extensions而非doc.properties，避免系统属性冲突。
需要为页面设置添加新的配置选项卡
需要向现有的页面设置组中注入或修改字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
用于在 Website Builder 中通过 DI 扩展点注入自定义查询参数到预览 URL，支持同步或异步修改逻辑及功能注册。
需要向预览 URL 添加自定义查询参数
需要在预览链接中注入签名令牌或租户标识
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
用于配置 Webiny API Lambda 包大小限制。当构建产物超过默认 4.5MB 或需收紧限制时，通过修改 webiny.config.tsx 中的扩展项解决构建失败问题，支持字节换算与错误排查。
API Lambda 构建因包体积过大失败
需要自定义 API 包的体积上限
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny后端API架构指南，涵盖特性注册、DI容器配置、Service与UseCase模式及命名规范，用于指导后端开发。
询问后端API架构设计
需要创建Webiny特性或模块
涉及依赖注入配置
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
指导在Webiny CMS中开发自定义批量操作，包括后端EntriesBulkAction实现及前端Admin按钮集成，涵盖数据加载、处理、任务收敛及防重复处理机制。
需要为CMS内容条目添加批量处理功能
实现后台批量任务逻辑
配置Admin端批量操作触发按钮
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何在Webiny中实现自定义CMS字段类型，涵盖扩展DataFieldBuilder、组合验证器接口、创建FieldTypeFactory、通过DI注册以及添加TypeScript模块声明以支持自动补全。
需要实现内置类型未覆盖的自定义CMS字段
为模型构建器配置新的字段类型和验证逻辑
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
提供Webiny框架中EventHandler的实现模式，涵盖命名规范、接口定义及DI依赖注入。强调将业务逻辑封装为可复用抽象，Handler仅作为薄层编排者，支持领域事件定义与发布，用于构建前后钩子及外部事件响应机制。
实现Webiny EventHandler
定义和发布领域事件
处理Before/After钩子逻辑
npx skills add webiny/webiny-js --skill webiny-event-handler-pattern -g -y
指导如何在Webiny中通过GraphQLSchemaFactory添加自定义GraphQL查询和变更，包括类型定义、解析器实现及依赖注入。
需要添加自定义GraphQL端点
创建新的GraphQL查询或变更
构建动态GraphQL输入模型
npx skills add webiny/webiny-js --skill webiny-custom-graphql-api -g -y
指导在Webiny框架中通过Api.Route注册自定义HTTP路由，实现HttpRouteHandler接口并配置方法、路径及依赖注入。
需要添加自定义HTTP端点
配置API路由处理器
集成依赖注入到HTTP处理逻辑
npx skills add webiny/webiny-js --skill webiny-http-route -g -y
Webiny API权限系统技能，涵盖基于Schema的权限定义、DI注入抽象及用例集成。用于实现读写删等权限检查、作用域控制及测试场景覆盖。
实现API授权逻辑
定义权限Schema
创建可注入权限抽象
检查资源访问权限
处理记录作用域限制
npx skills add webiny/webiny-js --skill webiny-api-permissions -g -y
Webiny UseCase 实现模式指南，涵盖依赖注入、Result 处理、错误类型、装饰器及 CMS 仓库构建。用于实现、注入或覆盖 Webiny UseCase，并指导通过 CMS 持久化数据的仓库开发。
需要实现或自定义 Webiny UseCase
在 Webiny 中进行依赖注入或错误处理
构建基于 CMS 的数据持久化仓库
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供Webiny v5至v6架构迁移模式，指导AI代理将旧版插件转换为基于DI的服务及事件处理器。
迁移Webiny v5代码到v6
转换Context Plugin为DI服务
适配事件订阅机制
npx skills add webiny/webiny-js --skill webiny-v5-to-v6-migration -g -y
指导在 Webiny 框架中通过 WebSocket 实现 API 到 Admin 端的实时通知推送，包括服务端发送和客户端监听响应。
需要向触发操作的用户推送实时进度或状态更新
需要在后台任务完成后刷新 UI 或显示 Toast 提示
npx skills add webiny/webiny-js --skill webiny-websocket-notifications -g -y
指导如何基于CliCommandFactory为Webiny CLI创建自定义命令，涵盖参数定义、终端输出及配置注册，支持数据迁移、代码生成等场景。
需要扩展Webiny CLI功能
创建自定义CLI命令或脚本
npx skills add webiny/webiny-js --skill webiny-cli-extensions -g -y
指导在Webiny项目中配置Auth0作为身份提供商，涵盖包安装、JWT映射、扩展组件注册及环境变量设置，用于替换默认Cognito认证。
配置Auth0 SSO
替换Cognito为Auth0
设置OIDC认证
映射JWT Claims
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在Webiny项目中配置Microsoft Entra ID作为联邦身份提供商，通过Cognito Federation实现SSO登录。
询问如何配置Microsoft Entra ID或Azure AD集成
需要设置Webiny的OIDC微软登录功能
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
指导在Webiny项目中配置Okta作为外部身份提供商，涵盖包安装、API配置类创建、React扩展组件集成及环境变量设置，实现OIDC认证和JWT映射。
配置Okta SSO或OIDC认证
替换Cognito使用Okta
映射JWT Claims到Webiny身份
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
Webiny框架中通用的依赖注入(DI)模式指南，涵盖扩展与核心开发场景。说明如何通过构造函数注入服务、配置dependencies数组及访问Logger等常用服务，确保类型安全与编译时验证，适用于API、Admin、CLI及基础设施扩展开发。
编写Webiny扩展时需要实现接口并注入依赖
理解或调试DI容器中的服务注册与实例化流程
在扩展中获取Logger、BuildParams等系统服务
npx skills add webiny/webiny-js --skill webiny-dependency-injection -g -y
提供Webiny全栈扩展的骨架结构与注册模式，涵盖API与Admin入口、共享领域层及包结构规范，指导开发者在扩展或核心包中正确构建和注册全栈功能。
创建同时包含API和Admin功能的Webiny扩展
需要理解全栈扩展的目录结构和入口注册机制
npx skills add webiny/webiny-js --skill webiny-full-stack-architect -g -y
提供 Webiny ACO 模块中文件夹及权限管理的抽象接口、用例和事件处理器参考。用于指导开发者正确导入和使用创建、删除文件夹及权限控制的相关类与类型。
需要实现文件夹或权限管理功能
查询 Webiny ACO 模块的 API 接口定义
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
提供无头 CMS API 中条目、模型及分组的抽象定义，涵盖数据库类型与 OpenSearch 搜索相关的事件处理器和用例实现模式。
需要集成或开发 Headless CMS 功能
处理 CMS 条目的 OpenSearch 搜索逻辑
查找 CMS 相关的类型定义和导入路径
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
Webiny文件管理API抽象参考，提供Asset交付相关的事件处理器和使用案例接口定义，辅助开发者集成文件管理服务。
需要实现文件上传或下载功能
查找File Manager API抽象类
集成Webiny文件存储服务
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供 Webiny API 调度器的核心抽象与类型定义，涵盖任务的创建、执行、查询、取消及命名空间处理。适用于后端业务逻辑中定时任务或延迟执行的开发场景。
需要实现定时或延迟执行的任务逻辑
查询或管理已排期的动作状态
集成 Webiny 调度器模块
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抽象，包括系统级安装用例和安装完成后的生命周期事件处理程序，辅助开发者实现系统初始化逻辑。
需要运行系统级安装流程
监听或处理系统安装完成事件
npx skills add webiny/webiny-js --skill webiny-api-system-catalog -g -y
提供多租户系统的核心API抽象，涵盖租户创建、删除、查询及应用安装的生命周期管理。包含使用案例和事件处理钩子，用于实现SaaS环境下的租户隔离与初始化逻辑。
需要实现多租户功能
处理租户生命周期事件
集成SaaS架构的API开发
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供 Webiny 租户管理 API 的抽象接口与使用案例，涵盖租户的创建、启用、禁用、更新及查询等功能，辅助开发者集成多租户逻辑。
需要实现或调用租户创建功能
处理租户状态变更如启用或禁用
查询特定租户信息
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
提供Webiny网站构建器的API抽象，涵盖页面与重定向的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云资源配置
配置基础设施环境参数如区域、标签或域名
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
提供 Webiny 本地开发与部署指南，涵盖环境管理、Watch 模式调试及 Lambda 模拟机制。
询问 Webiny 部署命令或环境配置
需要本地调试 API 或 Admin 应用
npx skills add webiny/webiny-js --skill webiny-local-development -g -y
指导在 Webiny 项目中通过 Api.Mailer.Smtp 组件配置 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/ 目录中 API、Admin、Infra 和 CLI 扩展的注册与组织方式。
询问 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，支持白标化（品牌、主题）、内容列表自定义列、页面表单及弹窗抽屉扩展。
需要修改管理后台品牌标识或主题颜色
需要为内容列表添加自定义列
需要创建或定制页面类型表单
需要注册自定义弹窗或抽屉组件
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
通过 AI Power Ups 扩展为 Headless CMS 条目生成、摘要或重写内容，支持配置模型与人设。
需要程序化生成 CMS 内容
在生命周期钩子中调用 AI
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置 Webiny 项目的 Cognito 联合登录，支持 Google、Facebook、Apple 及 OIDC/Entra ID 等外部身份提供商。涵盖基础设施搭建、管理员登录界面定制及 API 身份同步映射。
配置 Cognito 联合登录
添加外部身份提供商（如 Google、Microsoft）
自定义 Cognito 登录界面
处理 OAuth 重定向 URL
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
指导通过代码创建Webiny Headless CMS内容模型，涵盖ModelFactory模式、字段定义、验证、布局及SDK查询投影语法。
需要创建或修改CMS内容模型定义
配置字段类型、验证规则或Admin UI渲染器
处理引用字段与对象字段的SDK查询投影
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供Webiny管理后台ACO模块的两个核心React Hook抽象：useNavigateFolder用于文件夹导航，useRecords用于数据记录操作。
需要实现管理后台的文件夹导航功能
需要在前端组件中获取和管理数据记录
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
