auto-skill-maintainer

Auto Skill Maintainer（自动补齐技能）

触发条件

当你明确发现以下任一情况时，必须执行本技能：

• 之前的测试写法/目录落点/配置方式是错误的或与仓库惯例冲突
• 构建/测试链路存在“隐式知识”，导致后续容易重复踩坑
• 为了跑通实验临时做了 workaround，但正确做法应固化为可复用 skill
• 调试定位出新的常见失败模式/处置流程（例如 CI 资源约束导致的失败），而现有 skills 未覆盖该经验
• pr-workflow 或跨技能交付策略变更（例如 fmt 门禁顺序、手动 PR 提交、PR 草稿落点、上游正文规范、commit message 不含 Co-authored-by）— 必须在同一次 commit 中同步更新所有受影响的 skills（至少：experiment-guard、completion-examiner、report-generator、test-authoring、harness-overview），避免知识分叉

注意：该技能描述的是“必须做什么”，不代表运行环境会自动触发或自动执行。若工具侧不支持自动 hook，请在交付时明确说明已按本技能更新并提交。

门禁（push 安全策略）

• 默认只做 落盘 + 提交（commit）。
• 只有同时满足以下条件才允许 push：
  • 本地仓库存在 origin remote
  • 环境变量 HARNESS_AUTO_PUSH=1
  • 运行命令显式带 --push

执行步骤

1. 选择 skill 名称与目标：优先更新已有 skill；若不存在再创建新 skill。
2. 用脚本生成/确保 skill 与 plugin 注册：
   • python3 scripts/auto-skill.py ensure --name <skill-name> --description '<desc>' --commit
3. 把新知识写进 skill 的 skills/<skill-name>/SKILL.md（覆盖占位内容），并再次提交：
   • git add skills/<skill-name>/SKILL.md plugin.json
   • git commit -m 'harness: refine <skill-name>'
4. 若本次经验会影响多个技能（常见：pr-workflow + report-generator），要一次性更新完并在同一次提交中体现，避免知识分叉。
5. 做最小验证，确保注册与格式正确：
   • python3 -m json.tool plugin.json >/dev/null
6. 如果需要推送（满足门禁）：
   • HARNESS_AUTO_PUSH=1 python3 scripts/auto-skill.py ensure --name <skill-name> --description '<desc>' --push

输出要求

• skill 必须可复用：写清“什么时候用、怎么用、交付是什么”
• plugin.json 必须包含该 skill 的 skills/<name>/SKILL.md