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）拆解为基于垂直切片的多阶段实施计划。通过识别持久架构决策，生成端到端的可演示阶段，并与用户确认粒度后输出为本地 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环境。根据包配置自动选择yarn test或yarn test:os命令，提供维护清单的方法。
运行项目测试
执行单元测试
CI/CD测试流程
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类型定义、已知标志枚举、Zod校验及API集成步骤。
需要新增功能开关
配置FeatureFlags DTO
集成License检查逻辑
npx skills add webiny/webiny-js --skill webiny-add-feature-flag -g -y
提供Webiny管理后台扩展的架构模式，涵盖无头功能与展示功能的分层设计、目录结构及上下文差异。指导开发者正确注册特性、使用依赖注入及MobX状态管理。
构建Webiny Admin前端功能
定义Admin扩展的目录结构
实现UseCase/Repository/Gateway层
配置MobX Presenter和React组件
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
用于在Webiny管理后台注册权限UI及进行依赖注入支持的权限检查。涵盖基于Schema的自动生成表单、可注入权限检查、类型化Hooks及组件，支持简单应用和复杂多实体权限模式。
需要为管理界面添加权限控制逻辑
定义新的权限Schema或实体
在React组件中集成权限检查
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注册及UI组件开发。
需要为CMS内容模型添加自定义创建前导流程
实现前端表单交互逻辑与UI渲染
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于扩展网站构建器页面设置，支持添加新选项卡或修改现有组。通过实现特定接口并注册功能来定制页面配置抽屉，强调自定义数据应存储于doc.extensions而非系统属性中。
需要为页面设置添加新的自定义选项卡
需要向现有的页面设置组注入新字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
用于在Webiny网站构建器中注入自定义查询参数到预览URL，支持同步修改和异步获取远程令牌，涵盖接口实现、依赖注入注册及配置挂载全流程。
需要向预览URL添加自定义查询参数
需要在预览链接中注入签名令牌或租户标识
实现PreviewUrlModifier扩展点
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
用于配置 Webiny API Lambda 构建包的体积限制。通过 Infra.Api.MaxBundleSize 扩展调整默认 4.5MB 上限，解决包过大导致构建失败或强制更严格限制的问题。
API Lambda 构建包超过 4.5 MB 导致构建报错
需要自定义 API Bundle 的体积限制大小
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny框架后端API架构规范，涵盖DI容器注册、特性结构、Service与UseCase设计模式及命名约定。指导扩展与核心开发遵循统一架构标准，确保代码一致性与可维护性。
需要设计或实现Webiny后端API功能
理解Webiny依赖注入和特性注册机制
进行后端代码重构以符合架构规范
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
用于在 Webiny Headless CMS 中创建自定义批量操作，通过实现 EntriesBulkAction 接口定义 loadData 和 processData 逻辑，并配置 Admin UI 触发器。
需要为内容条目列表添加批量处理功能
实现后台异步任务以处理大量数据
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何为 Webiny CMS 实现自定义字段类型，包括扩展 DataFieldBuilder、创建工厂类、注册依赖注入及 TypeScript 模块增强。
需要实现内置类型之外的自定义 CMS 字段
为模型构建器添加新的 fluent API 字段方法
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
提供 Webiny 框架中 EventHandler 的实现规范，涵盖事件处理、依赖注入、领域事件定义及发布。强调将业务逻辑封装在可复用抽象中，Handler 仅作为薄层编排器，确保代码解耦与复用性。
实现 Webiny 事件处理器
定义和发布领域事件
配置 DI 依赖注入
重构内联业务逻辑
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端点
配置自定义路由处理器
设置API Gateway路由映射
npx skills add webiny/webiny-js --skill webiny-http-route -g -y
提供基于Schema的API权限系统实现指南，涵盖权限模式定义、依赖注入抽象及使用场景集成。
实现API授权逻辑
定义权限Schema
检查读写删权限
处理记录范围限制
npx skills add webiny/webiny-js --skill webiny-api-permissions -g -y
Webiny UseCase 实现模式指南，涵盖依赖注入、Result 错误处理、自定义实现注册及 CMS 数据持久化。用于指导开发者正确构建、注入和扩展业务逻辑单元。
实现新的业务用例
覆盖默认 UseCase 逻辑
配置依赖注入
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供Webiny v5至v6的迁移模式，指导将基于插件的架构转换为基于DI的功能模块，涵盖ContextPlugin转服务、事件订阅转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
指导如何通过CliCommandFactory为Webiny CLI创建自定义命令，包括参数定义、处理逻辑及注册方法。
创建自定义CLI命令
编写数据迁移脚本
构建代码生成器
npx skills add webiny/webiny-js --skill webiny-cli-extensions -g -y
指导在 Webiny 项目中集成 Auth0 作为身份提供商，包括安装依赖、配置 JWT 映射及 React 组件注册。
配置 Auth0 认证
替换 Cognito
设置 OIDC 外部身份提供商
JWT Claims 映射
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在Webiny项目中配置Microsoft Entra ID作为Cognito联邦身份提供商，涵盖应用注册、密钥获取及OIDC映射设置。
配置 Microsoft Entra ID
Azure AD 集成
Microsoft SSO 设置
OIDC 微软登录
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
指导在 Webiny 项目中配置 Okta 作为身份提供商，替代默认 Cognito。涵盖安装包、创建 JWT 映射配置类、集成 React 扩展组件及设置环境变量，实现 OIDC 认证和 SSO 登录流程。
配置 Okta 身份提供商
替换 Cognito 为 Okta
设置 OIDC 认证
映射 JWT claims
自定义 Okta 登录流程
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
说明 Webiny 框架通用的依赖注入模式，涵盖扩展与核心开发中的构造函数注入、依赖声明及工厂实现方法。
编写 Webiny 扩展或核心代码
需要理解依赖注入机制
配置服务依赖关系
npx skills add webiny/webiny-js --skill webiny-dependency-injection -g -y
提供全栈扩展的骨架结构和注册模式，用于创建同时包含API和Admin功能的Webiny扩展，支持共享领域层及分层架构。
创建全栈扩展
配置Api.Extension与Admin.Extension
npx skills add webiny/webiny-js --skill webiny-full-stack-architect -g -y
提供Webiny ACO模块中文件夹及权限相关的API抽象、用例和事件处理器，辅助开发者实现文件夹创建、删除及权限管理功能。
需要实现文件夹或权限的CRUD逻辑
集成Webiny后端API功能
查找特定UseCase或EventHandler接口
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
Webiny Headless CMS API 技能，提供内容条目、模型及分组的抽象定义与事件处理器。涵盖 OpenSearch 搜索、过滤、排序等核心功能，用于构建和管理无头 CMS 后端服务。
需要集成或扩展 Webiny Headless CMS 的 API 接口
实现基于 OpenSearch 的内容搜索、过滤和排序逻辑
处理 CMS 内容条目的创建、更新或删除事件
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
提供Webiny文件管理API中48个抽象接口（如Asset、Authorizer等）的导入路径与源码位置，辅助开发者实现文件事件处理和使用案例。
需要集成或扩展文件上传下载功能
查找文件管理相关的类型定义和接口
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供Webiny调度器API的15种抽象定义，涵盖定时任务的创建、执行、取消、查询及命名空间处理等功能，辅助开发者集成调度逻辑。
需要实现定时任务功能
查找调度器API接口和类型
npx skills add webiny/webiny-js --skill webiny-api-scheduler-catalog -g -y
提供 Webiny API 安全与认证相关的 53 个抽象类索引，涵盖认证、API Key、角色、用户及团队的事件处理器和使用案例，辅助开发者快速定位接口。
需要实现 API 身份验证逻辑
管理 API Key 的创建、更新或删除事件
配置用户或角色的权限钩子
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
提供多租户生命周期管理API抽象，涵盖租户创建、删除、查询及应用安装功能，并包含前后事件处理器钩子。
需要实现或理解多租户架构中的租户生命周期逻辑
开发涉及租户创建、删除或应用安装的业务用例
集成租户相关的事件处理程序
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供 Webiny 租户管理 API 的 9 个核心抽象类，涵盖租户创建、启用、禁用、更新及查询等用例。指导开发者导入并使用这些接口进行多租户应用的后端业务逻辑开发。
需要实现租户创建或管理功能
查找 Webiny 租户相关的 API 接口定义
集成多租户架构的后端服务
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
提供Webiny网站构建器中页面和重定向的API抽象参考，涵盖创建、删除、获取页面及重定向等用例的实现模式与导入路径。
需要实现页面或重定向的CRUD功能
查询Webiny网站构建器的API接口定义
npx skills add webiny/webiny-js --skill webiny-api-website-builder-catalog -g -y
提供Webiny基础设施扩展抽象，涵盖管理后台和API的构建、部署及监听钩子，支持Pulumi集成与堆栈输出服务。
配置基础设施构建或部署流程
集成Pulumi进行云资源管理
处理Admin或Api的生命周期钩子
npx skills add webiny/webiny-js --skill webiny-infra-catalog -g -y
提供基于 Pulumi 的 AWS 基础设施扩展能力，支持通过 Handler 自定义资源及声明式组件配置 VPC、OpenSearch、域名和蓝绿部署等。
需要修改或添加 AWS 云资源
配置基础设施环境参数如 VPC、标签或区域
设置自定义域名或蓝绿部署策略
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
提供 Webiny 本地开发与部署指南，涵盖环境管理、Watch 模式调试及 Lambda 开发机制。
询问 Webiny 部署命令
配置本地 Watch 开发环境
排查 Lambda 或 Admin 调试问题
管理长短期环境
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 的作用
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
需为内容列表添加自定义列
创建自定义页面类型表单
注册命名对话框或抽屉组件
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
通过调用AI Power Ups扩展生成Headless CMS条目内容，避免直接调用LLM。适用于在代码中程序化生成、摘要或重写内容，支持用户配置的模型和角色设定。
需要生成CMS条目内容时
希望在代码中集成用户配置的AI设置进行内容处理
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置Webiny项目中Cognito联合身份认证，支持Google、Entra ID等外部提供商登录。涵盖基础设施配置、管理后台登录界面定制及API身份映射，实现用户自动同步与角色分配。
配置Cognito联合登录
添加外部身份提供商(SSO)
自定义Cognito登录界面
处理OIDC/OAuth重定向
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
指导通过 ModelFactory 模式使用代码创建和修改 Headless CMS 内容模型，涵盖字段定义、验证、布局及 SDK 查询投影语法。
创建新的 CMS 内容模型
修改现有模型字段或验证规则
配置 Admin UI 渲染器
解决 SDK 查询中 ref 字段的投影问题
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供Webiny管理后台ACO模块的两个核心React Hooks抽象：useNavigateFolder用于文件夹导航，useRecords用于记录数据获取。旨在简化前端组件对业务逻辑的调用。
需要实现管理后台的文件夹导航功能
需要在React组件中获取和管理ACO记录数据
npx skills add webiny/webiny-js --skill webiny-admin-aco-catalog -g -y
提供Webiny管理后台AI功能模块的抽象接口说明，指导开发者通过指定路径导入GetSettingsFeature等组件以集成AI能力。
需要集成Webiny AI Powerups功能
查找admin/ai-powerups模块下的可用抽象接口
npx skills add webiny/webiny-js --skill webiny-admin-ai-powerups-catalog -g -y
