ai-proj-helper/MAINTENANCE.md

技能维护节奏

配套 SCOPE.md（收不收）、skill-creator（怎么建）、docs/skill-routing.md（用哪个）。 本文件管「多久做一次什么」。

每次改动（任何 PR）

1. 过 SCOPE.md 收录门槛（真实失败 + 组合不出来），新技能默认先 beta。
2. 跑四道门禁：validate-skills.py --strict、scan-skill.sh、generate-catalog.py --check、tests/install-skills.test.sh。
3. 技能有增删改 → 同步回改 docs/skill-routing.md 与 catalog.json。
4. 更新 plugin.json 版本号与 CHANGELOG.md。

每日（随 7:30 项目日报）

• 两台机器跑 install-skills.sh --audit：drift > 0 就要报，并注明是「未安装 / 版本落后 / 本地改动」。
• 门禁失败或扫描出高危：立即处理，不等到日报。
• 例外：beta 与 deprecated 不计入 drift。

每周一 10:00 — evals 抽样回归

• 范围：上周改过的技能 + 3 个高风险技能（dev-coding、dev-review、req-design）。
• 每技能取 1 条关键用例，做「有技能 / 无技能」对比，按 rubric 打分。
• 结果记录到 reports/evals/YYYY-Www.md，进周报。
• 连续两次无增量的技能 → 按 SCOPE.md 评估降级。
• 不做全量（61 技能 × 3 用例成本过高）；全量只在治理大改时做。

每月 1 日 10:00 — 漂移与目录审阅

• 两台机器 --audit 漂移必须为 0（beta/deprecated 除外）。
• 审 catalog.json：description 长度 <80 或 >600 的标黄；含「各种 / 等等 / 相关」这类泛化词的标出。
• 第三方技能（arkcli 等）有变动时，评估是否影响团队技能。

每季度首月 1 日 10:30 — 治理复核

• 人工过一遍 docs/skill-routing.md：删掉不再用的引用、补上新技能。
• 清理 deprecated：满 3 个月且无回滚需求 → 删除插件目录。
• 复核分桶与调用模式：还有没有命令型技能占着 model-invoked。
• 更新本文件与 CHANGELOG.md。

责任分工

• 项目经理 Bot：执行节奏、出周/月报、盯漂移与门禁。
• 改技能的 agent：负责门禁四件套与路由回改。
• 人工拍板项：废弃技能、路由变更、promoted 晋升。