johnQ
04e20babc1
skill-gate / gate (pull_request) Waiting to run
- hooks/git/{pre-commit,pre-push} + scripts/install-git-hooks.sh（Gitea Actions 无 runner，本地兜底）
- install-skills.sh: --scope project --project-dir（装到项目 .agents/skills）
- scripts/scan-installed.sh: 扫第三方已装技能（33 个，0 高危）
- generate-catalog: has_evals/has_docs + coverage；validate --coverage + 路由一致性检查
- SCOPE 覆盖率路线图（3-4 周补齐 40 个技能的 evals 与四段式文档）
- MAINTENANCE/README/CHANGELOG 同步
2.7 KiB
2.7 KiB
技能维护节奏
配套
SCOPE.md（收不收）、skill-creator（怎么建）、docs/skill-routing.md（用哪个）。 本文件管「多久做一次什么」。
每次改动（任何 PR）
- 过
SCOPE.md收录门槛（真实失败 + 组合不出来），新技能默认先beta。 - 跑四道门禁：
validate-skills.py --strict、scan-skill.sh、generate-catalog.py --check、tests/install-skills.test.sh。- 本机已用
./scripts/install-git-hooks.sh装好 pre-commit / pre-push，commit/push 时自动执行；Gitea Actions 暂无 runner，不能依赖 CI。 - 跳过单次：
SKILL_GATE_SKIP=1 git commit ...，提交信息里写原因。
- 本机已用
- 技能有增删改 → 同步回改
docs/skill-routing.md与catalog.json。 - 更新
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 等）有变动时，评估是否影响团队技能；跑一次
./scripts/scan-installed.sh。 - 跑
python3 scripts/validate-skills.py --coverage：报告缺 evals / 缺四段式文档的技能，按SCOPE.md的覆盖率路线图推进。
每季度首月 1 日 10:30 — 治理复核
- 人工过一遍
docs/skill-routing.md：删掉不再用的引用、补上新技能。 - 清理
deprecated：满 3 个月且无回滚需求 → 删除插件目录。 - 复核分桶与调用模式：还有没有命令型技能占着
model-invoked。 - 复核覆盖率：
--coverage的两项缺口是否按路线图收敛。 - 更新本文件与
CHANGELOG.md。
责任分工
- 项目经理 Bot：执行节奏、出周/月报、盯漂移与门禁。
- 改技能的 agent：负责门禁四件套与路由回改。
- 人工拍板项：废弃技能、路由变更、
promoted晋升。