关于 governance
governance 是用于设计系统演进管理的 Skill,涵盖版本、贡献与弃用规则,并指导变更分类及完成前所需的检查。
主要功能
- 01按 SemVer 级别分类变更
- 02制定组件与令牌晋升标准
- 03规定弃用周期与迁移映射
- 04更新文件索引与变更日志
- 05检查令牌有效性和颜色对比度
适用场景
- 01确定设计系统变更的版本级别
- 02规划令牌或组件的弃用与迁移
- 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或安装插件,然后停止。不要猜测 无法打开的文件内容。
随着系统不断发展,保持一致性。应用版本控制、贡献和弃用规则。
步骤
- 阅读
${CLAUDE_SKILL_DIR}/../../../workflows/governance.md(SemVer 表、贡献工作流、弃用政策、变更沟通)。 - 对变更分类:major(破坏性变更:重命名/移除 token 或 prop,变更结构/默认值)、minor(新增内容:新 token/组件/变体/可选 prop)、patch(修复:容错范围内的对比度/错误/文档/数值调整)。
- 对于新组件/token:在将其从产品级提升为候选级,再提升为核心级之前,确认它能满足真实且重复出现的需求(≥ 2 处)。按照完整质量标准进行设计(
${CLAUDE_SKILL_DIR}/../../../.claude/rules/components.md→ 组件质量标准)。 - 对于弃用:标明原因、替代方案和移除版本;至少保留一个 minor 周期的可用性;提供迁移映射(参照
${CLAUDE_SKILL_DIR}/../../../design-systems/crosswalk.md的风格);仅在 major 版本中移除。 - 将任何新文件添加到
CLAUDE.md(文件引用映射及相关表格/路由),并添加变更日志条目。
验证(完成标准)
- 变更已标注 SemVer 级别,并且有变更日志条目。
- 移除项有弃用期限、替代方案和迁移表。
- 新规范满足 8 种状态 + a11y + token 映射标准,并可通过路由访问。
python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py通过;如果颜色有变更,则重新检查对比度。
评论
支持 Markdown