Prompts · 反复用的那几条

删掉它 Claude 还能做对就不写，做不对才写。写入：接口陷阱（“connect() 返回 bool 不是 tuple”）、硬约束（“必须 TDD”）、环境限制（“XX 包不在 PyPI”）。不写入：变更日志（git log 知道）、API 用法示例（Claude 搜源码就有）、“本项目使用 FastAPI”（README 的事）。根 CLAUDE.md ≤ 40 行，详细规则拆到 .claude/rules/*.md。

默认主会话用 Grep / Glob / ace-tool；只有需要多轮探索或跨多个信息源整合才 spawn。能 ace-tool 一步搞定的语义搜索禁止 spawn Explore（双重浪费 ~30K token）。模型选择：sonnet 用于中等任务（代码探索、文档生成）；opus 仅用于深度推理（架构、复杂 bug）。未指定时默认 sonnet，不要继承父级的 opus。

写之前问三遍：① 这条是通用知识（任何工程师都会）还是特殊知识（本项目独有）？② 假设删掉，新会话是否仍然天然会做对？③ 如果新会话天然会考虑，写进 memory 等于反复提醒已知常识，纯噪声。通用工程常识 → 不写；项目级特殊事实（API 陷阱、历史决策原因、业务约束） → 可写。分不清优先不写。

Skill 的 description 字段是匹配触发的唯一依据。穷举所有可能的用户措辞：中英双语、口语化变体、隐式意图。反例：“用于 X”（模糊，模型不会主动触发）；正例：“当用户提到 X / Y / Z / 帮我搞个 W 时使用”（穷举触发词）。描述里写明“不适用于 X 场景”可降低误触发。触发率低就加词，误触发多就加排除项。

路由表强制顺序。行为描述（“X 在哪里 / 怎么实现”）→ ace-tool 语义索引；已知精确标识符（函数 / 类名）→ Grep；已知文件路径 → Read；路径模式 → Glob；git 历史 → git CLI。ace-tool 返回空就立即回落 Grep 不重试；Grep 试错 3-5 次没结果就切 ace-tool。量化：路由用错来回多花 ~5K token。

识别时机：写“只做 X 不做 Y”时、Review 出现“范围外”建议、PR 描述出现“不涉及 / 保持不变 / 超出范围”字样时。覆盖场景：技术债、对称缺失、Schema 迁移遗漏、设计稿差距。同步操作：写 memory/<topic>.md + MEMORY.md 加索引 + PR 描述末尾加引用。为什么：“保持不变”只是事实陈述，无追踪机制下次会话就丢。

三步：① dry-run 预演（rm 无 dry-run 时用 ls -la <target> 看清要删什么）；② du -sh <对象> / git log -1 -- <path> 验证对象身份与重要性；③ 仅在二次验证后实际执行。trap 内禁止写 rm -rf —— 触发时不知道脚本停在哪一步，盲删可能毁掉用户原始数据。改用 sentinel 文件标记进度 + 检查后清理，或干脆不写 trap。

Claude Code 的 session / memory / todo 都按“项目绝对路径”哈希存储在 ~/.claude/projects/<hash>/。重命名或移动项目文件夹后，新路径哈希变了，看起来“Claude 把项目忘了”。claude-repath 自动：扫旧路径条目 → 重命名 hash 目录 → 修正 ~/.claude.json 项目列表。症状：CC 提示“找不到 session”、todo 消失、memory 文件没加载。