Agf skill stocktake

Skill pcliangx/AppGenesisForge/.claude/skills/agf-skill-stocktake

AI Agent Team scaffold for Claude Code — 19 roles collaborate through stage gates, enforced by mandatory skills + blocking hooks + DoD checklists. Spec-driven change folders, SIT-audited code reviews, 4-layer hook defense, multi-LLM (DeepSeek/Doubao/Qwen/MiniMax). Tracks: Web · WeChat Mini Program · Apple native (macOS/iOS). 中文/EN README.

Install

npx -y skills add pcliangx/AppGenesisForge --skill agf-skill-stocktake

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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.md

5.2 KB, as published. Nobody here has run it

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 维必须验路径（静默腐化高发点）：

# 验 skill 引用的路径存在
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）