| name | tag-ci |
| description | 为本仓库的 cheatsheet 条目处理标签选择、补标、纠错、归一化和新标签创建策略的技能。用于用户提到补标签、核查标签、统一标签体系、修正误标、增加筛选标签、维护 tags/tags-define.yml 或 tags/tags-icon.yml 时;也用于在创建或重建 cheatsheet 时决定 meta.yml 的 tags。 |
tag-ci
为本仓库统一维护 cheatsheet 标签体系,并保证 meta.yml、tags/tags-define.yml、tags/tags-icon.yml 三者一致。
唯一事实源
- 标签分组定义只认
tags/tags-define.yml
- 标签图标映射只认
tags/tags-icon.yml
- 条目实际使用只写在
cheatsheets/<topic>/meta.yml 的 tags
- 不在其他技能、脚本说明、模板说明里重复声明标签规则;其他地方只引用本技能
处理范围
- 补齐或修正
meta.yml 的 tags
- 将旧标签、英文标签、近义标签归一到当前体系
- 判断某条 cheatsheet 是否应属于
自动化工具、CLI 工具、脚本工具 等已有标签
- 必要时新增标签,并同步维护标签定义和图标映射
使用策略
- 先读
tags/tags-define.yml,确认当前允许使用的标签集合和所属分组
- 再读
tags/tags-icon.yml,确认该标签是否已有图标映射
- 再读目标条目的
meta.yml、正文摘要、refmap.md 或项目主页,判断实际能力与场景
- 优先复用已有标签;只有现有集合明显无法表达时才新建标签
选标签规则
- 优先覆盖“平台 / 领域”“工具类型”“使用阶段”“交互形态”四个维度中的高价值标签
工具类型 是首要维度;像 CLI 工具、自动化工具、脚本工具、AI 辅助工具 这类标签优先判断
- 标签应反映“这个项目是什么”和“拿它来做什么”,不要只摘正文里的零散关键词
- 单条 cheatsheet 一般保持精简,优先保留 3 到 6 个高辨识度标签
- 避免把描述词、功能点、实现细节直接当标签;例如版本号、具体命令名、局部 API 名称通常不应入标签
创建新标签
仅在以下条件同时满足时创建:
- 现有标签确实无法覆盖该概念
- 该概念具有复用价值,预期不只服务单个条目
- 命名足够稳定,不是临时性说法
创建时必须同步执行:
- 把新标签加入
tags/tags-define.yml 的合适分组
- 把新标签加入
tags/tags-icon.yml
- 在目标
meta.yml 中使用新标签
- 确认没有更合适的旧标签需要替换或移除
归一化规则
- 优先使用当前项目主体系中的中文标签
- 历史英文标签如
Automation、CLI、Test、Extension、Web,应优先收敛到对应中文标签
- 若一个条目同时存在“旧标签 + 归一化后新标签”,保留新标签,移除旧标签
- 若某条目被误标为某工具类型,但它更像交互入口、平台、库或插件,应移除错误工具类型标签
与其他技能协作
cheatsheet-maker 在处理 meta.yml.tags 时应调用或遵循 tag-ci
icon-complete-skill 只管图标文件,不负责标签策略
- 如果新增标签导致导航页筛选或标签图标展示受影响,最后执行
npm run build:nav
自检
meta.yml 中的每个标签都能在 tags/tags-define.yml 中找到
- 新标签都已写入
tags/tags-icon.yml
- 没有在别的技能文档中重复维护标签策略
- 标签数量克制,且能支持导航页筛选
- 构建导航页后,新增或修正的标签能正常显示