用途:离线审计过去的 Claude Code 会话记录,诊断反复出现的摩擦,并加固导致摩擦的工具、规则和技能。核心原则:工具与规则重构在专门会话中进行,功能开发中途的摩擦先记 /sharpen-later 书签;反复出现或安全关键的失败改用 hook、权限规则或 CLI 包装器,而非软提示;规则用肯定式表述。
主要能力:脚本 scripts/sharpen_saw.py 位于该技能目录,需 Python 3.9+,读取 ~/.claude/projects/ 下的会话记录且不载入上下文,默认不含子智能体会话(除非加 --include-subagents)。支持 scan(按正则筛选会话并按失败排序)、audit(对最近 N 个会话生成 8 段报告)、view(查看书签附近或某会话的失败步骤)、resolve(关闭书签)。
使用方式:先与用户确定目标领域与回溯窗口(默认 14 天),再运行一次离线扫描,例如:python3 <skill-dir>/scripts/sharpen_saw.py scan --query "\b(git|gh)\b|rebase" --days 14 --limit 5 或 python3 <skill-dir>/scripts/sharpen_saw.py audit --last 5 --prompts first。--prompts none 可在会话含私密内容时排除用户提示。需要上下文时用 view,例如 python3 <skill-dir>/scripts/sharpen_saw.py view <L-id>、view <session-prefix> --errors、view <session-prefix> --step 40 --window 3。
报告与修复:先写 tool_optimization_report.md,按根因(认知/注意力、工具缺口、策略模糊、迭代挣扎)分类,并区分技能是发现失败、遵循失败还是覆盖缺口。修复分四层:全局规则(~/.claude/CLAUDE.md)、hook 与包装器(~/.claude/settings.json、~/.local/bin)、技能(~/.claude/skills/<name>/SKILL.md,最多 250 行)、项目文档(仓库 CLAUDE.md)。SKILL.md 单次增幅不超过 20%,超出则拆入 references/。确认后应用修复,并用 resolve 关闭书签,记录旧症状正则,一周后复查是否复发。
限制:仅审计本地会话记录,需 Python 3.9+;默认不含子智能体会话;修改磁盘前须获用户同意;其余细节资料未提供。