15-playbooklisted

# 指令库（Playbook） **核心定位**：把历史踩坑沉淀成可复用的指令模板，让用户不用每次现场组织语言就能用上"最佳指令"。 ## 库的位置 ``` ~/.claude/prompts/ ├── README.md 库说明 ├── index.yaml 元数据索引（必读，做匹配用） ├── lib/ 场景模板正文 └── modifiers/ 修饰符（可叠加到任何模板） ``` ## 调用形式 | 用户输入 | 行为 | |---------|------| | `/pb` 或 `/playbook` 或 `/pb list` | 列出所有模板速查表 | | `/pb <自然语言描述>` | 模糊匹配 → 候选 → 注入完整行为契约 | | `/pb <模板> <修饰符>...` | 组合：模板 + 修饰符 | | `/pb help` | 显示用法说明 | ## Claude 收到 `/pb` 后的行为 ### 第 1 步：读 index.yaml 任何 `/pb` 调用第一件事： ``` 读 ~/.claude/prompts/index.yaml ``` 不要凭记忆猜模板存不存在 — 索引是真理来源。 ### 第 2 步：判断意图 | 用户输入形式 | 判断 | |------------|------| | `/pb` 或 `/pb list` | 列表模式 | | `/pb help` | 帮助模式 | | `/pb <文字>` | 匹配模式 | ### 第 3 步：匹配模式 — 自然语言匹配 读 index.yaml 后，按以下顺序匹配： 1. **精确匹配 id**：用户输入完全等于某个 `id` → 直接选定 2. **触发词匹配**：用户输入包含某模板的 `triggers` 关键词 → 强候选 3. **语义匹配**：用户输入与模板 `title` 或 `description` 语义相近 → 弱候选 **多个候选**：列出 top 3，让用户选： ``` 找到几个相关模板： 1. **反复修不好的 bug** (02-诊断, severity: high) - 用于：同一个 bug 修了 ≥2 次还没解决 - 触发词：反复修不好 / 改了又冒新bug 2. **审计后批量修** (02-诊断, severity: high) - 用于：审计发现一批问题需要批量处理 - 触发词：审计发现一批问题 / 一堆问题要修 你想用哪个？或者描述更多场景细节我重新匹配。 ``` **强匹配（top 1 远远超过其他）**：直接确认 + 注入，不用问。 ``` 匹配到 **反复修不好的 bug** (02-诊断) 我会按这个模板的行为契约处理。如要换模板告诉我。 [然后注入模板内容] ``` ### 第 4 步：识别修饰符叠加 如果用户输入里同时出现修饰符触发词（"超谨慎" / "全量回归" / "深度思考" / "不部署" / "操作前必问"）： - 自动叠加对应修饰符 - 在确认时明示："已叠加 修饰符A + 修饰符B" 例： ``` 用户：/pb 部署 超谨慎 不部署 匹配：deploy-triple-guard 模板 + 超谨慎 + 不部署 修饰符 （注：超谨慎和不部署看起来矛盾 — 用户可能想说"做部署前的所有检查但先不真的部署"，确认下意图） ``` ### 第