Playbooks
可立刻照着做的步骤清单。与 ../methodology/ 的区别:playbooks 是操作手册,不是思想。
命名
<playbook-slug>.md。
frontmatter 必填
---
title: <playbook 名>
scope: [individual, team, ecosystem]
maturity: draft | active | deprecated
last-updated: YYYY-MM-DD
tools-needed: [<工具名>, ...] # 可选
---
内容骨架(建议)
- 什么时候用
- 前置条件
- 步骤(编号清单,每步一句话)
- 验证(怎么知道做完了)
- 回滚(如果出错怎么办)
候选 playbooks
setup-personal-agent-domain.md(个人域,scope=individual)dispatch-task-to-codex-mcp.md(个人域跨 Agent 调度)start-new-project-controller.md(新建项目 Controller,scope=team)propose-l3-change.md(按 change-protocol L3 走完一遍,scope=ecosystem)
已发布的 playbooks
Meta(先读这个决定用哪个专用 playbook)
| Playbook | scope | 用途 |
|---|---|---|
| 文档工作流 Meta-Playbook | ecosystem | 跨层级 / 跨操作类型的共性方法论 + 决策矩阵 + 决策树 + 专用 playbook 导航。任何文档工作流启动前先读这一个 |
专用 playbooks(按文档层级 × 操作类型)
| Playbook | 覆盖层级 × 操作 | 配套模板目录 | 来源工作流 |
|---|---|---|---|
| 架构文档重构 Playbook | L3 × 重写 | templates/architecture-document-rewrite/ | 从 FinBayes 项目 2026-05 架构 v1→v2 重写工作流提炼,含方法论矩阵(arc42 / C4 / ADR / DDD / Google Design Doc 等)+ 五条核心范式 + 11 Phase 流程 + 项目特化适配指南,适用 DH / TM / RLE / FEFM 等生态内项目复用 |
| 文档 review 范式 Playbook | 任意层级 × review / 审计 / PR review | 无 | 从 FinBayes 项目 2026-05 11 步 review + Step 11 整改沉淀。含复杂度阈值禁抽查规则(> 100K chars 强制完整通读)+ 三视角(治理 / 主控 / 工程实施)+ AI 三方互审协议(Claude + Codex + 第三方 AI fresh-eyes 二阶)+ 问题驱动→根因驱动切换条件。任何 review 启动前先读这一个 |
待起草的专用 playbooks(实战驱动)
下列 playbook 在生态内有实际场景需要时按 meta-playbook §8 起草指南起草:
strategic-whitepaper-workflow.md(L1 × 新建/重写/演化)product-definition-workflow.md(L2 × 新建/重写/演化)engineering-pack-creation.md(L4 × 新建)cross-document-alignment.md(跨层级 × 对齐)document-deprecation.md(任意层级 × 弃用)