Menu
ai-playbook handbook (3986 行) 智能查询入口。当用户/任务提到 §NN.M 章节号、 "手册"、"playbook"、"铁律 #N"、"反模式"、"竞品" 等关键词时自动触发。 读 INDEX.md 决定该读哪段 handbook，避免每次塞 3986 行全文进上下文。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
yakuten (hrtyaku.com) 网站运营/SEO 作战入口。当用户要求：分析 GA/GSC 数据、看流量/排名/搜索词、 出 SEO 报告、推荐 SEO 文章选题、优化 CTR/meta/AEO、内容更新计划、"网站运营" 等任务时触发。 分析由 Claude 本人完成（不调 Gemini；scripts/seo/ai-analyze.mjs 仅为 CI 无人值守备用）。
§37 Constitution 协议自动加载器（对齐 GitHub Spec Kit）。当用户请求涉及 spec/plan/ feature/architecture/decision/release 或开始新任务时自动触发。读取项目 docs/ai-cto/CONSTITUTION.md 并把项目特定的不可妥协约束注入响应。
§35 Eval-Driven Development 强制规则（铁律 #12）。当 Claude 编辑 .claude/commands/、 .claude/agents/、.claude/skills/、.agents/skills/、CLAUDE.md、playbook/handbook.md、 .claude/output-styles/ 等 prompt/agent 配置类文件时自动加载。 强制：无 eval 不进 main。配套 eval-gate.sh 注入 PostToolUse 提醒。
§32.1 Forbidden 路径强制规则。当 Claude 编辑 auth/payment/billing/secrets/keys/migration/ crypto/infra/terraform/ansible/.github/workflows 路径下文件时自动加载。要求 spec-driven、 双签、PR 标签 requires-double-review。配套 .claude/hooks/forbidden-guard.sh 硬阻止 (exit 2)；本 skill 提供 Claude 应如何响应被阻止时的处理流程。
v3.9 Bugbot-style learned rules 自动加载器（Cursor 启发，44k learned rules 验证）。 当 Claude 触及 .claude/rules/learned/ 目录或被 /cto-evolve apply 写入新 learned rule 时自动加载。把项目历次自审 / cross-review / commit 沉淀的具体教训注入上下文， 避免重复犯同类错。
§20.3 Test-Lock 规则（铁律 #14）。当 Claude 编辑测试文件 (tests/、__tests__/、 *.test.{ts,tsx,js,jsx,py}、*.spec.*、*_test.{py,go}) 时自动加载。强制： AI 只能改实现不能改断言；改测试需符合合法场景之一并显式标注 commit message。 配套 .claude/hooks/test-lock-guard.sh 注入 PreToolUse 提醒。
| name | handbook-search |
| description | ai-playbook handbook (3986 行) 智能查询入口。当用户/任务提到 §NN.M 章节号、 "手册"、"playbook"、"铁律 #N"、"反模式"、"竞品" 等关键词时自动触发。 读 INDEX.md 决定该读哪段 handbook，避免每次塞 3986 行全文进上下文。 |
| user-invocable | false |
| when_to_use | 用户提到 §<数字>.<数字> 章节引用、"手册第 N 节"、"playbook 说"、"铁律 #N"、 "反模式 #N"、"按手册"、handbook.md 的具体章节查询时。 |
handbook.md 有 3986 行 / 49 章节。把它全部塞进上下文是反 §4.1 的（attention budget 浪费）。 本 skill 提供"先读 INDEX，再读对应章节"的两段式查询。
test -f playbook/INDEX.md && cat playbook/INDEX.md
INDEX.md 维护"章节 → 关键词 → 行号范围"映射。例：
§32.1 Forbidden 路径 | auth/payment/secrets/migration | L2400-2480
§35 Eval-Driven Dev | golden trajectory / CI gate / mutation | L2680-2780
§44 Deterministic Replay | trajectory jsonl / cost / replay | L3470-3570
| 用户问题模式 | 应查 |
|---|---|
| "§32.1 怎么说的" | 直接读 L<起>-<止> |
| "铁律 #13 是什么" | grep "铁律 #13" 后定位章节 |
| "vibe coding 反模式" | 搜 §32.5 / §33 |
| "什么是 spec-driven" | §18 |
| "Constitution 怎么写" | §37 / docs/ai-cto/CONSTITUTION.md |
| "怎么跨模型 review" | §48 |
| "怎么写 eval" | §35 / evals/golden-trajectories/ |
用 Read 工具的 offset + limit：
Read(file_path="playbook/handbook.md", offset=2400, limit=80)
用 §N.M 格式精准引用：
"按手册 §32.1（L2400-2480），forbidden 路径定义为 ..."
| 反模式 | 应当 |
|---|---|
直接 Read playbook/handbook.md（全文） | 先读 INDEX 定位 |
| Grep handbook 抓上下文 | INDEX 已索引，grep 是 fallback |
| 凭记忆引用 §N.M | 必须 Read 实际行号确认（铁律 #2） |
| 不引用直接说"手册说" | 必须用 §N.M 格式让用户能查证 |
"⚠️ playbook/INDEX.md 不存在（v3.8 应有）。
fallback: 用 grep 找章节。
建议：跑 cto-audit 或手动维护 INDEX.md。"
playbook/INDEX.md（章节索引 SSOT）playbook/handbook.md（3986 行原文）