| name | agf-skill-stocktake |
| description | Use when PL / tech-lead audits the content quality of AGF's own skills (`.claude/skills/agf-*/SKILL.md`). Provides the 5-dimension checklist (Actionability / Scope fit / Uniqueness vs CLAUDE.md+standards / Currency of pointers / Gate-binding validity), 5-verdict rubric (Keep/Improve/Update/Retire/Merge), reason-quality bar (反敷衍), and output skeleton. Triggered each MINOR release retro or manually. |
Skill Stocktake（AGF 自有 skill 内容质量审计）
Use this skill when:
- MINOR release retro 时审 AGF 自有 skill 是否腐化
- 手动盘点 skill 质量（感觉 skill 集膨胀 / 指针过期 / 内容重叠）
- 新增 / 删除 skill 后回归一次确保无重叠
What it is — and is not
Skill Stocktake 审计 AGF 自有治理型 skill 的内容质量——不是语法（lint-all.sh 管）、不是 SSOT drift（gen-roles.py --check 管）。它审 skill 是否仍 actionable / scope-fit / unique / 指针新鲜 / 绑定有效 gate。
不审：第三方 skill（docx / pptx，Anthropic 提供，非 AGF 治理资产）。
Scope
.claude/skills/agf-*/SKILL.md。以 ls .claude/skills/agf-*/SKILL.md 实际为准，不在文档硬编码计数（守 verified-facts.md 纪律）。
5 维 checklist（每 skill 逐条核）
AGF 在 ECC 4 维上加 1 维 Gate 绑定（AGF 治理型 skill 的核心——每个 agf-* 都该绑一个受治理流程 + gate）：
- Actionability：有可立即执行的步骤 / 命令 / 代码示例（不是空泛原则）
- Scope fit：name / trigger（description）/ 内容对齐，不过宽不过窄
- Uniqueness：内容不被
CLAUDE.md / standards/ / 另一 skill 替代（守 SSOT，不重复）
- Currency（指针新鲜度）：引用的
CLAUDE.md / standards/*.md / docs/adr/*.md 路径仍存在 + 内容同步（用 rg / [ -f ] 验路径，抽查引用内容是否漂移）
- Gate 绑定有效性（AGF 特有）：skill 是否仍绑一个有效 gate / SSOT 命令（如
agf-deploying-uat 绑部署门 + /agf-deploy-uat；agf-writing-change 绑变更文件夹 + agf-spec-validate）。无 gate 的 skill 要么是知识型（说明）要么是孤儿（候选 Retire）
5 档 verdict
| Verdict | 含义 |
|---|
| Keep | 5 维全过，仍有效 |
| Improve | 值得保留但需具体改进（指明哪段 / 什么改 / 目标规模） |
| Update | 引用的技术 / 路径过期（rg / WebSearch 验证后更新） |
| Retire | 低质量 / 过时 / cost-asymmetric（说明什么覆盖了它） |
| Merge into [X] | 与另一 skill 重叠（指明目标 + 整合什么内容） |
Reason 质量要求（反敷衍）
评估是整体 AI 判断（非数值 rubric）。但 reason 字段必须自包含、可决策：
- ❌ 不写 "unchanged" / "overlaps with X" 这种空话
- ✅ Retire：(1) 发现什么具体缺陷 (2) 什么覆盖了同一需求
- Bad:
"Superseded"
- Good:
"agf-writing-prd 已 v6.9.0 弃用，agf-writing-change 覆盖全部场景 + delta + archive；无独有内容残留"
- ✅ Merge：目标 skill + 整合什么内容
- ✅ Improve：哪段、什么改、目标规模
- ✅ Keep（仅 mtime 改）：重述原 verdict 依据，不写 "unchanged"
流程
1. Inventory
ls .claude/skills/agf-*/SKILL.md
2. 逐 skill 评估
对每个 skill：Read SKILL.md → 5 维核对 → 填 verdict + reason。
Currency 维必须验路径（静默腐化高发点）：
rg -oE '\[.*?\]\(([^)]+)\)' .claude/skills/agf-<name>/SKILL.md | ...
[ -f <引用路径> ] && echo OK || echo STALE
skill 数量以 ls .claude/skills/agf-*/SKILL.md | wc -l 实际为准（一批跑完，不需要 chunk / resume；ECC 的 chunk 是为 261 skill 设计，AGF 裁剪掉）。
3. 输出
写 docs/reviews/skill-stocktake-<YYYY-MM-DD>.md：
- frontmatter（
reviewer / date / scope: agf-* / skill_count）
- 汇总表（Skill | Verdict | Reason 一行）
- 按 verdict 分组详情
- 改进项（Improve / Update / Retire / Merge 的具体 action 清单）
4. PL 决策
Retire / Merge 涉及删 / 合 skill，PL 确认后才动（不自动删——守 agf-writing-change 变更门，删 skill 是 REMOVED Requirement 级变更）。Improve / Update 由 PL 派 maintainer 或 tech-lead 执行。
触发节奏
- 每 MINOR release retro：作为 retro 的可选步骤（见
agf-running-release-retro）
- 手动：PL / tech-lead 觉得 skill 集膨胀 / 指针过期时随时跑
- PATCH 不跑：skill 腐化慢，MINOR 周期够
- MAJOR release 前：强烈建议跑一次（大版本是清理窗口）
Anti-patterns
- ❌ 把 stocktake 当 lint 跑（语法 / drift 是
lint-all.sh + gen-roles.py --check 的事）
- ❌ 审第三方 skill（
docx / pptx 非 AGF 治理资产）
- ❌ Retire / Merge 不经 PL 确认直接删 / 合（违反变更门）
- ❌ reason 写 "unchanged" / "overlaps"（反敷衍要求）
- ❌ 跳过 Currency 维的
rg 验证（指针过期是静默腐化，不验 = 没审）
- ❌ 硬编码 skill 计数（以
ls 实际为准，守 verified-facts.md）
