关于
用于审计 Claude 技能和命令的质量。支持快速扫描（仅变更技能）和完整盘点模式，使用顺序子代理批量评估。
name: skill-stocktake description: "用于审计 Claude 技能和命令的质量。支持快速扫描（仅变更的技能）和完整盘点模式，使用顺序子代理批量评估。" origin: ECC
skill-stocktake
斜杠命令（/skill-stocktake），使用质量检查清单 + AI整体判断来审计所有 Claude 技能和命令。支持两种模式：快速扫描用于最近变更的技能，完整盘点用于全面审查。
范围
该命令针对以下路径（相对于调用目录）：
| 路径 | 描述 |
|------|-------------|
| ~/.claude/skills/ | 全局技能（所有项目） |
| {cwd}/.claude/skills/ | 项目级技能（如果目录存在） |
在阶段 1 开始时，命令会明确列出找到并扫描了哪些路径。
针对特定项目
要包含项目级技能，从该项目的根目录运行：
cd ~/path/to/my-project
/skill-stocktake
如果项目没有 .claude/skills/ 目录，则只评估全局技能和命令。
模式
| 模式 | 触发条件 | 持续时间 |
|------|---------|---------|
| 快速扫描 | results.json 存在（默认） | 5-10 分钟 |
| 完整盘点 | results.json 不存在，或 /skill-stocktake full | 20-30 分钟 |
结果缓存： ~/.claude/skills/skill-stocktake/results.json
快速扫描流程
仅重新评估自上次运行以来变更的技能（5-10 分钟）。
- 读取
~/.claude/skills/skill-stocktake/results.json - 运行：
bash ~/.claude/skills/skill-stocktake/scripts/quick-diff.sh \ ~/.claude/skills/skill-stocktake/results.json（项目目录从$PWD/.claude/skills自动检测；仅在需要时显式传递） - 如果输出为
[]：报告"自上次运行以来无变更。"并停止 - 使用相同的阶段 2 标准仅重新评估那些变更的文件
- 从之前的结果中保留未变更的技能
- 仅输出差异
- 运行：
bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \ ~/.claude/skills/skill-stocktake/results.json <<< "$EVAL_RESULTS"
完整盘点流程
阶段 1 — 清单
运行：bash ~/.claude/skills/skill-stocktake/scripts/scan.sh
脚本枚举技能文件，提取前置元数据，并收集UTC修改时间。
项目目录从 $PWD/.claude/skills 自动检测；仅在需要时显式传递。
展示脚本输出的扫描摘要和清单表：
Scanning:
✓ ~/.claude/skills/ (17 files)
✗ {cwd}/.claude/skills/ (not found — global skills only)
| 技能 | 7天使用 | 30天使用 | 描述 | |-------|--------|---------|-------------|
阶段 2 — 质量评估
启动一个 Agent 工具子代理（通用代理），提供完整清单和检查清单：
Agent(
subagent_type="general-purpose",
prompt="
Evaluate the following skill inventory against the checklist.
[INVENTORY]
[CHECKLIST]
Return JSON for each skill:
{ \"verdict\": \"Keep\"|\"\"Improve\"|\"\"Update\"|\"\"Retire\"|\"\"Merge into [X]\", \"reason\": \"...\" }
"
)
子代理读取每个技能，应用检查清单，并返回每个技能的JSON：
{ "verdict": "Keep"|"Improve"|"Update"|"Retire"|"Merge into [X]", "reason": "..." }
分块指导： 每次子代理调用处理约20个技能以保持上下文可管理。每个分块后将中间结果保存到 results.json（status: "in_progress"）。
所有技能评估完成后：设置 status: "completed"，进入阶段 3。
恢复检测： 如果启动时发现 status: "in_progress"，从第一个未评估的技能恢复。
每个技能按此检查清单评估：
- [ ] 检查与其他技能的内容重叠
- [ ] 检查与 MEMORY.md / CLAUDE.md 的重叠
- [ ] 验证技术参考的时效性（如果存在工具名称/CLI标志/API，使用 WebSearch）
- [ ] 考虑使用频率
判定标准：
| 判定 | 含义 | |---------|---------| | Keep（保留） | 有用且当前 | | Improve（改进） | 值得保留，但需要具体改进 | | Update（更新） | 引用的技术已过时（通过 WebSearch 验证） | | Retire（退役） | 低质量、过时或成本不对称 | | Merge into [X]（合并到[X]） | 与另一个技能有大量重叠；指定合并目标 |
评估是整体AI判断 — 不是数字评分。指导维度：
- 可操作性: 代码示例、命令或步骤，让你能立即行动
- 范围适配: 名称、触发条件和内容一致；不过于宽泛或狭窄
- 唯一性: 价值不可被 MEMORY.md / CLAUDE.md / 其他技能替代
- 时效性: 技术参考在当前环境中有效
原因质量要求 — reason 字段必须自包含且支持决策：
- 不要单独写"unchanged" — 始终重述核心证据
- 对于 Retire：说明 (1) 发现了什么具体缺陷，(2) 什么替代方案覆盖了相同需求
