用途:在 Gutenberg 检出环境中规划或实现 WordPress 设计系统相关包(@wordpress/components、@wordpress/ui、@wordpress/theme)的改动时使用。若不在检出环境,可从 GitHub 上 Gutenberg 的 .agents/skills/design-system-contribution/ 解析相关链接。
主要能力与流程:先阅读受影响包的 AGENTS.md 及相关贡献指南。选择最小改动:修复缺陷时复现失败并确定要恢复的行为;重构时确定要保留的行为;新增能力需有具体用例并说明现有公开组合为何不足。选择组件或令牌时,可用设计系统 MCP 服务器的 get_components、get_component_details、get_design_tokens;无 MCP 时参考指南推荐来源与令牌参考,并在添加看似缺失的 API 前检查当前源码。
保持契约:遵循包的组件、prop/ref、状态与样式约定,复用现有组合与辅助函数。删除、替换或行为变更时,用兼容性指南比较新旧契约,并纳入插件与 npm 消费者。令牌变更按语义用途与受影响模式选择,遵循令牌源指南与构建流程;Emotion 迁移使用 emotion-to-scss-modules。仅当在独立更新的包与 WordPress 版本间更改契约时,才使用 package-runtime-compatibility。
验证:从现有测试与 stories 开始,仅针对代码或集成引入的具体回归风险补充覆盖,依赖依赖自身的测试。需要浏览器检查时使用指南的验证选项。更改组件推荐时,同步更新 Storybook 状态、精选清单标签、ESLint 推荐列表、迁移指南与生成的清单快照。遵循完成检查,覆盖受影响导出、文档、生成文件与变更日志,以及仓库必需检查。存在实质验证缺口时如实说明,不得仅凭快照或类断言声称视觉一致。
限制:产品特定行为应留在消费包中,使用 design-system-ui-composition 处理;未决的公开设计决策需先遵循 Contributing to the Design System。