Agent Skills
› webiny/webiny-js
webiny/webiny-js
GitHub通过持续追问和压力测试，帮助用户深入梳理计划或设计中的决策分支，消除歧义并达成共同理解。
安装全部 Skills
npx skills add webiny/webiny-js --all -g -y
集合内 Skills (85)
按质量分展示前 50 个（共 85 个），完整列表请用安装命令预览或逐个打开详情。
通过持续追问和压力测试，帮助用户深入梳理计划或设计中的决策分支，消除歧义并达成共同理解。
用户希望压力测试计划
用户要求对设计进行严苛审查
用户提到 '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检查、完整构建及测试。测试需按包顺序执行并按32个用例分片，确保代码质量和构建产物符合发布标准。
准备发布Webiny包前
需要验证包依赖和构建状态
npx skills add webiny/webiny-js --skill preflight -g -y
指导如何运行测试，区分DDB和OpenSearch场景。根据包配置决定执行yarn test或yarn test:os，并列出需双运行的包、仅OpenSearch的包及其他包的默认命令，同时提供更新列表的方法。
用户询问如何运行特定包的测试
用户需要执行OpenSearch相关测试
用户不确定应使用哪个测试命令
npx skills add webiny/webiny-js --skill tester -g -y
引导用户通过访谈和代码库探索，梳理需求与模块设计，最终生成结构化 PRD 并作为 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后台扩展的架构规范，涵盖无头功能与展示功能的分层设计、DI容器注册及React集成模式。
开发Webiny管理后台扩展
构建Admin侧前端组件
npx skills add webiny/webiny-js --skill webiny-admin-architect -g -y
指导在Webiny管理后台注册权限UI及通过DI进行权限检查，涵盖Schema定义、依赖注入配置及类型安全的Hooks和组件使用。
添加管理后台权限控制
配置权限Schema
实现基于DI的权限检查
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注册及React组件实现，用于优化内容录入体验。
需要为CMS内容模型添加自定义创建向导
希望在进入主编辑器前收集标题或分类等初始数据
npx skills add webiny/webiny-js --skill webiny-new-entry-wizard -g -y
用于扩展网站构建器页面设置，支持添加新选项卡或修改现有组。涵盖创建自定义设置组、注入字段及数据持久化规范，确保自定义数据存储于doc.extensions而非系统属性中。
需要为页面设置添加新的自定义选项卡
需要向现有的页面设置组（如SEO、常规）中添加或修改字段
npx skills add webiny/webiny-js --skill webiny-page-settings-extensions -g -y
用于在 Webiny Website Builder 中通过扩展点向预览 URL 注入自定义查询参数，支持同步/异步修改及依赖注入注册。
用户需要向预览链接添加认证令牌或租户标识
用户希望动态修改页面编辑器的预览 URL 参数
npx skills add webiny/webiny-js --skill wb-preview-url-modifier -g -y
用于配置 Webiny API Lambda 构建包的体积上限。当包大小超过默认限制导致构建失败，或需调整限制时，通过修改 webiny.config.tsx 中的 Infra.Api.MaxBundleSize 扩展项解决。
API Lambda 构建包超过 4.5MB 限制导致构建报错
需要自定义或收紧 API 构建包的体积限制
npx skills add webiny/webiny-js --skill api-bundle-size-limit -g -y
Webiny后端API架构指南，涵盖特性注册、DI容器、Service与UseCase设计模式、命名规范及反模式，用于指导后端开发。
需要设计或实现Webiny后端API功能
询问关于DI容器注册、Service/UseCase职责划分的问题
查找后端代码结构模板或命名约定
npx skills add webiny/webiny-js --skill webiny-api-architect -g -y
用于在 Webiny Headless CMS 中创建自定义批量操作（EntriesBulkAction），实现后台任务处理与 Admin UI 触发，涵盖数据加载、分批处理及状态收敛机制。
需要为内容条目列表添加批量操作功能
开发自定义后台批量处理逻辑
集成 Admin UI 批量操作按钮
npx skills add webiny/webiny-js --skill webiny-cms-bulk-actions -g -y
指导如何在 Webiny CMS 中实现自定义字段类型，涵盖扩展 DataFieldBuilder、组合验证器、创建工厂类、通过 DI 注册及 TypeScript 模块增强，以支持 Fluent API 和自动补全。
需要实现内置类型之外的自定义 CMS 字段
为 ModelFactory 添加新的字段构建方法
npx skills add webiny/webiny-js --skill webiny-api-cms-custom-field-type -g -y
提供 Webiny 框架中 EventHandler 的实现模式，涵盖命名规范、接口定义、依赖注入及领域事件发布。强调将业务逻辑封装为可复用抽象，Handler 仅作为薄层编排器，适用于前后钩子实现与自定义事件开发。
需要实现 Webiny 事件处理器
定义或发布领域事件
处理 CMS 或租户生命周期钩子
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路由处理程序
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实现模式指南，涵盖DI注入、Result错误处理、装饰器及CMS数据持久化。用于指导开发者规范地创建、注入、覆盖和扩展业务用例逻辑。
需要实现新的业务用例
配置依赖注入或覆盖默认实现
处理业务逻辑中的错误与结果类型
npx skills add webiny/webiny-js --skill webiny-use-case-pattern -g -y
提供 Webiny v5 到 v6 的迁移模式，指导将插件架构转换为基于 DI 的特性架构，包括 ContextPlugin 转服务及事件订阅转 EventHandler。
Webiny 版本升级迁移
插件架构重构为依赖注入
npx skills add webiny/webiny-js --skill webiny-v5-to-v6-migration -g -y
实现Webiny平台中API向Admin端发送实时WebSocket通知的功能。支持服务端推送消息，客户端监听并触发UI更新或Toast提示，适用于后台任务进度反馈等场景。
需要在后端操作完成后实时通知前端用户
实现基于WebSocket的服务器到客户端消息推送
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 Claims
npx skills add webiny/webiny-js --skill webiny-configure-auth0 -g -y
指导在 Webiny 项目中通过 Cognito Federation 配置 Microsoft Entra ID (Azure AD) 作为联合身份提供商，涵盖应用注册、密钥获取及 OIDC 集成步骤。
询问如何配置 Microsoft Entra ID 或 Azure AD
需要设置 Microsoft SSO 或 OIDC 登录
涉及 Webiny 与 Microsoft 365 账户连接
npx skills add webiny/webiny-js --skill webiny-configure-entraid -g -y
指导在Webiny项目中配置Okta作为身份提供商，替代默认Cognito。涵盖安装包、创建API配置映射JWT声明、编写React扩展组件、注册扩展及设置环境变量等步骤，实现SSO和自定义登录流程。
配置Okta认证
替换Cognito为Okta
设置OIDC身份提供商
映射JWT claims到Webiny身份
npx skills add webiny/webiny-js --skill webiny-configure-okta -g -y
说明 Webiny 框架中通用的依赖注入模式，涵盖扩展与核心开发的构造函数注入、服务访问及依赖声明规则。
编写 Webiny 扩展需要理解依赖注入
使用 Logger/BuildParams/CMS 用例等可注入服务
配置 dependencies 数组或实现 *.Interface
npx skills add webiny/webiny-js --skill webiny-dependency-injection -g -y
提供全栈扩展骨架与注册模式，指导如何构建同时包含API和Admin的Webiny扩展。涵盖共享领域层、入口点声明及包结构规范，区分插件与核心开发上下文。
创建同时涉及API和Admin功能的Webiny扩展
需要配置全栈扩展的顶层组件和入口点
npx skills add webiny/webiny-js --skill webiny-full-stack-architect -g -y
提供Webiny ACO模块中文件夹及权限相关的32个抽象接口，包括UseCase、Repository和EventHandler。用于指导开发者正确导入和使用文件夹创建、删除、权限管理等核心功能的类型与实现模式。
需要实现或调用Webiny ACO中的文件夹管理功能
查询文件夹级别权限(FLP)的API抽象定义
寻找文件夹生命周期事件处理器的使用方式
npx skills add webiny/webiny-js --skill webiny-api-aco-catalog -g -y
Webiny Headless CMS API 抽象参考，提供内容条目、模型及组的事件处理器和用例接口。涵盖 OpenSearch 搜索、过滤、排序等核心功能，指导开发者导入类型并实现业务逻辑。
需要集成或扩展 Webiny Headless CMS 的 API 功能
查询 CmsEntry 或 OpenSearch 相关接口的定义与用法
npx skills add webiny/webiny-js --skill webiny-api-cms-catalog -g -y
Webiny文件管理器API的48个抽象定义，涵盖资产交付、处理及事件处理器用例。提供接口类型与导入路径指引，辅助开发者实现文件管理功能。
需要实现文件上传或下载逻辑
查找文件管理相关的TypeScript接口
集成Webiny文件管理服务
npx skills add webiny/webiny-js --skill webiny-api-file-manager-catalog -g -y
提供 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 系统安装相关的抽象定义，包括安装用例和生命周期事件处理器，指导开发者导入并使用这些核心功能。
需要初始化或安装 Webiny 系统
监听系统安装完成事件
查找系统安装相关的 API 接口
npx skills add webiny/webiny-js --skill webiny-api-system-catalog -g -y
提供 Webiny 多租户 API 的 17 个抽象，涵盖租户生命周期管理及安装事件处理。包括创建、删除、查询租户用例及前后钩子，辅助开发者实现多租户应用集成与运维。
需要创建或删除租户
实现多租户应用安装逻辑
监听租户生命周期事件
npx skills add webiny/webiny-js --skill webiny-api-tenancy-catalog -g -y
提供多租户管理相关的API抽象与用例，涵盖租户的创建、安装、启用、禁用、更新及查询等功能，并支持租户模型扩展。
需要实现多租户系统的CRUD操作
处理租户生命周期事件如创建或禁用
扩展租户数据模型字段
npx skills add webiny/webiny-js --skill webiny-api-tenant-manager-catalog -g -y
Webiny网站构建器API技能，提供58个页面与重定向相关的事件处理器和用例抽象。涵盖页面的增删改查、版本管理及URL重定向管理，用于后端业务逻辑实现。
需要创建或管理网站页面
需要配置URL重定向规则
查询页面详情或历史版本
开发网站构建器后端功能
npx skills add webiny/webiny-js --skill webiny-api-website-builder-catalog -g -y
提供Webiny基础设施的35种抽象扩展，涵盖Admin和Api构建、部署及监听等生命周期钩子。用于定义和管理云资源堆栈及自动化流程。
配置基础设施构建或部署流程
集成Pulumi管理云资源
处理应用发布前后逻辑
npx skills add webiny/webiny-js --skill webiny-infra-catalog -g -y
通过Pulumi处理程序和声明式组件自定义AWS基础设施，支持VPC、OpenSearch、标签、域名及蓝绿部署等配置。
需要修改AWS基础设施资源
配置OpenSearch或VPC网络
设置自定义域名或SSL证书
启用蓝绿部署策略
npx skills add webiny/webiny-js --skill webiny-infrastructure-extensions -g -y
指导 Webiny 项目的本地开发与部署，涵盖使用 yarn webiny deploy 进行环境管理和发布，以及通过 watch 模式在本地调试 API 和 Admin 应用。
询问 Webiny 部署命令或环境管理
配置本地开发或调试 Lambda/React 应用
npx skills add webiny/webiny-js --skill webiny-local-development -g -y
用于在 Webiny 项目中配置 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.config.tsx 作用
了解如何注册扩展
区分不同扩展类型
npx skills add webiny/webiny-js --skill webiny-project-structure -g -y
用于根据源码和文档生成、更新及维护 Webiny MCP Server 技能库的元技能，支持全量重建或单技能创建。
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 编辑器。通过 React 组件注册实现界面个性化与功能增强。
需要修改 Webiny 后台的 Logo、标题或主题颜色
需要在内容管理列表中增加自定义数据列
需要为网站构建器页面类型创建自定义表单
需要注册命名对话框或抽屉以从任意位置调用
需要扩展或修改 Lexical 富文本编辑器的行为
npx skills add webiny/webiny-js --skill webiny-admin-ui-extensions -g -y
在 Webiny Headless CMS 中通过 AI Power Ups 扩展，以编程方式生成、摘要或重写 CMS 条目内容。开发者可注入用例并配置提示词及角色，自动调用用户配置的 LLM 提供商，返回生成的 JSON 数据供后续处理。
需要批量更新 CMS 内容
在生命周期钩子中自动生成字段
通过自定义 Mutation 触发 AI 内容创作
npx skills add webiny/webiny-js --skill webiny-ai-powerups-content -g -y
配置 Webiny 项目中通过 Cognito 实现外部身份提供商（如 Google、Apple）的联合登录，涵盖基础设施、管理后台登录界面及 API 身份映射的全流程。
配置 Cognito 联合登录
添加外部 IdP 认证
自定义管理员登录界面
处理 OAuth 重定向
npx skills add webiny/webiny-js --skill webiny-cognito-federation -g -y
通过代码创建和配置 Headless CMS 内容模型，涵盖字段定义、验证规则、布局及引用关系处理。
需要以编程方式定义 CMS 内容模型结构
配置字段类型、验证器或 Admin UI 渲染器
解决 SDK 查询中 ref 与 object 字段的投影语法问题
npx skills add webiny/webiny-js --skill webiny-api-cms-content-models -g -y
提供Webiny ACO模块的React Hooks抽象，包括useNavigateFolder和useRecords，用于管理文件夹导航和数据记录操作。
需要实现文件夹导航功能
需要获取和管理数据记录
npx skills add webiny/webiny-js --skill webiny-admin-aco-catalog -g -y
提供Webiny管理后台AI增强功能的抽象接口，如获取设置功能。帮助开发者快速集成和调用AI相关能力。
需要集成Webiny AI功能
查找AI增强模块的导入路径
npx skills add webiny/webiny-js --skill webiny-admin-ai-powerups-catalog -g -y
