技能审查 是做什么的？
斜杠命令（/技能审查），使用质量检查清单 + 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
该脚本枚举技能文件，提取 frontmatter，并收集 UTC mtime。
项目目录自动从 $PWD/.claude/skills 检测；仅在需要时显式传递。
显示脚本输出中的扫描摘要和清单表格：
正在扫描：
✓ ~/.claude/skills/ (17 个文件)
✗ {cwd}/.claude/skills/ (未找到 — 仅全局技能)
| 技能 | 7 天使用 | 30 天使用 | 描述 |
|---|
阶段 2 — 质量评估
启动一个 Agent 工具子代理（通用代理），包含完整的清单和检查清单：
Agent(
subagent_type="general-purpose",
prompt="
根据以下检查清单评估技能清单。
[INVENTORY]
[CHECKLIST]
为每个技能返回 JSON：
{ "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] | 与另一个技能有实质重叠；指明合并目标 |
评估是整体性 AI 判断 — 而非数字评分标准。指导维度：
- 可操作性：可以立即执行的代码示例、命令或步骤
- 范围契合度：名称、触发器和内容保持一致；不过宽或过窄
- 独特性：价值不可被 MEMORY.md / CLAUDE.md / 其他技能替代
- 时效性：技术引用在当前环境中有效
原因质量要求 — reason 字段必须自成体系且能支持决策：
- 不要单独写“未更改” — 始终重述核心证据
- 对于 Retire：说明 (1) 发现了什么具体缺陷，(2) 什么替代方案覆盖了相同的需求
- 错误：
"已取代" - 正确：
"disable-model-invocation: true 已设置；已被 continuous-learning-v2 取代，该技能覆盖了所有相同模式并增加了置信度评分。没有剩余独特内容。"
- 错误：
- 对于 Merge：指明目标并描述要整合的内容
- 错误：
"与 X 重叠" - 正确：
"42 行单薄内容；chatlog-to-article 的步骤 4 已经覆盖相同的工作流。将该‘文章角度’提示作为备注整合到该技能中。"
- 错误：
- 对于 Improve：描述所需的具体更改（什么部分、什么操作、相关目标大小）
- 错误：
"太长" - 正确：
"276 行；‘框架比较’部分 (L80–140) 重复了 ai-era-architecture-principles；删除它以缩短至约 150 行。"
- 错误：
- 对于 Keep（快速扫描中仅 mtime 更改）：重述原始裁决理由，不要写“未更改”
- 错误：
"未更改" - 正确：
"mtime 已更新但内容未变。独特的 Python 引用被 rules/python/ 显式导入；未发现重叠。"
- 错误：
阶段 3 — 汇总表
| 技能 | 7 天使用 | 裁决 | 原因 |
|---|
阶段 4 — 整合
- Retire / Merge：在确认前，每个文件提供详细的依据：
- 发现的具体问题（重叠、过时、引用错误等）
- 覆盖相同功能的替代方案（对于 Retire：哪个现有技能/规则；对于 Merge：目标文件和要整合的内容）
- 删除的影响（任何依赖的技能、MEMORY.md 引用或受影响的工作流）
- Improve：提供具体的改进建议及理由：
- 要更改的内容及原因（例如，“将 430 行缩减至 200 行，因为 X/Y 部分重复了 python-patterns”）
- 用户决定是否执行
- Update：提供已更新的内容及已检查的引用来源
- 检查 MEMORY.md 行数；如果超过 100 行，建议压缩
结果文件模式
~/.claude/skills/skill-stocktake/results.json：
evaluated_at：必须设置为评估完成时的实际 UTC 时间。
通过 Bash 获取：date -u +%Y-%m-%dT%H:%M:%SZ。切勿使用仅包含日期的近似值，如 T00:00:00Z。
{
"evaluated_at": "2026-02-21T10:00:00Z",
"mode": "full",
"batch_progress": {
"total": 80,
"evaluated": 80,
"status": "completed"
},
"skills": {
"skill-name": {
"path": "~/.claude/skills/skill-name/SKILL.md",
"verdict": "Keep",
"reason": "具体、可操作、对 X 工作流具有独特价值",
"mtime": "2026-01-15T08:30:00Z"
}
}
}
注意事项
- 评估是盲测：无论技能来源如何（ECC、自创、自动提取），均适用相同的检查清单
- 归档/删除操作始终需要用户明确确认
- 不根据技能来源进行裁决分支