SuperAPI AI 工具集

my-skills-standards-update

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:把 CODING_STANDARDS.md 的新基线版本升级到其他仓库中已生成的标准文件。它遵循 my-skills-maintenance 的共享规则(仓库锚点 $REPO、先提议后写入、先验证后报告、GLOSSARY 词汇、收尾提议);强制的 stray check 不适用于本分支,因为它不涉及 skills/ 或 store。创建文件由 setup-coding-standards 负责(文件已存在时它会停止),本分支只负责已有文件的更新路径。

主要能力与流程:

  1. 收集目标仓库:从用户提供的列表,或扫描用户指定目录(一层深度,查找 CODING_STANDARDS.md)。没有该文件的仓库跳过。
  2. 按 stamp 分类:stamp 是生成时的标记行 <!-- end of baseline v<N>; ... -->。当前版本从源文件读取:grep -o 'baseline v[0-9]*' "$REPO/skills/self/setup-coding-standards/references/baseline.md" | tail -1。无 stamp 为 legacy,需人工判断合并;vN ≥ 当前则跳过;vN < 当前为升级候选。
  3. 组合升级、展示 diff 后写入:新文件 = baseline.md 原文(含其 stamp 行)+ 旧文件 stamp 行以下所有行。机械操作:ML=$(grep -n 'end of baseline' CODING_STANDARDS.md | cut -d: -f1);{ cat "$REPO/skills/self/setup-coding-standards/references/baseline.md"; tail -n +$((ML+1)) CODING_STANDARDS.md; } > CODING_STANDARDS.md.new。写入前做两项字节一致性校验(新 stamp 以上区域等于 baseline.md;新 stamp 以下区域等于旧文件 stamp 以下区域),然后展示 diff,按仓库逐一等待用户确认后才写入;被拒绝的候选保持不动。
  4. 报告:按仓库列出跳过、已最新、已升级、legacy、被拒绝。提交由用户按仓库决定,每次提交属于目标仓库。

限制:不创建新文件;legacy 文件不做机械升级,需与用户人工判断合并;不硬编码版本号;写入前必须获得用户逐仓库确认。