mcpField
G
governance

governance

github.com/plugin87设计与 UI3.0k486 次安装1 天前更新
代码仓库

关于 governance

governance 是用于设计系统演进管理的 Skill,涵盖版本、贡献与弃用规则,并指导变更分类及完成前所需的检查。

主要功能

  1. 01按 SemVer 级别分类变更
  2. 02制定组件与令牌晋升标准
  3. 03规定弃用周期与迁移映射
  4. 04更新文件索引与变更日志
  5. 05检查令牌有效性和颜色对比度

适用场景

  1. 01确定设计系统变更的版本级别
  2. 02规划令牌或组件的弃用与迁移
  3. 03评审拟纳入核心的新组件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill governance

安装后在 Claude Code 中输入/governance确认已加载。

详细介绍

技能:治理

第 0 步:工具包在这里吗? 此技能会读取工具包中的文件。检查一次: ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING 只有在 KIT_MISSING 时,才表示安装的只有技能文件夹,这是 npx skills add 的行为。请明确说明这一点,指引用户使用 npx ux-ui-agent-skills init 或安装插件,然后停止。不要猜测 无法打开的文件内容。

随着系统不断发展,保持一致性。应用版本控制、贡献和弃用规则。

步骤

  1. 阅读 ${CLAUDE_SKILL_DIR}/../../../workflows/governance.md(SemVer 表、贡献工作流、弃用政策、变更沟通)。
  2. 对变更分类:major(破坏性变更:重命名/移除 token 或 prop,变更结构/默认值)、minor(新增内容:新 token/组件/变体/可选 prop)、patch(修复:容错范围内的对比度/错误/文档/数值调整)。
  3. 对于新组件/token:在将其从产品级提升为候选级,再提升为核心级之前,确认它能满足真实且重复出现的需求(≥ 2 处)。按照完整质量标准进行设计(${CLAUDE_SKILL_DIR}/../../../.claude/rules/components.md → 组件质量标准)。
  4. 对于弃用:标明原因、替代方案和移除版本;至少保留一个 minor 周期的可用性;提供迁移映射(参照 ${CLAUDE_SKILL_DIR}/../../../design-systems/crosswalk.md 的风格);仅在 major 版本中移除。
  5. 将任何新文件添加到 CLAUDE.md(文件引用映射及相关表格/路由),并添加变更日志条目。

验证(完成标准)

  • 变更已标注 SemVer 级别,并且有变更日志条目。
  • 移除项有弃用期限、替代方案和迁移表。
  • 新规范满足 8 种状态 + a11y + token 映射标准,并可通过路由访问。
  • python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py 通过;如果颜色有变更,则重新检查对比度。

评论

支持 Markdown