手册架构约定 · V1

真源：块一 / 块二 / 方法论 / docs/ 如何分工；新 Agent、新模块如何接入。
菜单快照：published-menu-v3

1. 一句话分工

	块一 · 转型全家桶	块二 · AI 产品 Agent
是什么	40 天总览 + 学习大纲 + 作业验收	工具与场景真源，长期维护
更新频率	阶段结构、路径分叉、里程碑	新 Agent、新模块、工作流、模板
读者问	「第几天交什么？」	「平台 / 这个 Agent 怎么用？」
不该写	Coze 六模块全文、7 阶段逐步截图	路径 A/B/C、Day 9–22 节奏

块一 = 地图；块二 = 地形图 + 工具箱。 地图标「到这里读块二 §1.4」，不抄 §1.4 全文。

2. 三角索引

text

                    docs/（研发真源 · 学员不直读）
                              │
                              ▼ 蒸馏
         ┌────────────────────┴────────────────────┐
         │          块二 · Agent 工具手册          │
         │   平台 · AgentPM · 7阶段 · 模板       │
         └────────────────────┬────────────────────┘
                              │ 双链（不重复正文）
         ┌────────────────────┼────────────────────┐
         ▼                    ▼                    ▼
   块一 · 阶段二          Part IV · 方法论      Part III · 案例库
   路线 + 作业            SDAD · 五步法          叙事 · 跟做

3. 五条不可违反规则

新垂直 Agent（母婴馆、养虾等）→ 增 块二 §2 场景列表（agent/scenarios/{slug}.md）+ 案例库；块一只加 双链一行。
AgentPM → §2.1（§2 下旗舰场景 · 全家桶默认）；与其它应用型 Agent 同章不同页。
Coze / 平台模块正文 → 只在 块二 §1；阶段二 2.2–2.3 仅导读 + 练习 + 链。
7 阶段交付流水线 → 真源 块二 §3；阶段二 2.4 只写跟练步骤与作业（主要针对 §2.1 AgentPM）。
派活 / 人审 / PRD / 五件套模板 → 真源 块二 §5；阶段二 2.5 / 2.9 索引。
SDAD 理论 → 方法论单源；块二、块一只链，不重写 L1–L5 全文。

4. `docs/` 四轮 · 阶段二必修映射

轮次	主题	核心 docs	落在手册
认知轮	为什么、边界	`02` `52` `40`	块二 §1.10 · 阶段二 2.2
方法轮	0→1、架构	`52` `17` `16`	方法论五步法 · 块二 §1.1
深度轮	RAG、成本、案例	`29` `44` `46` `37` `38`	块二 §1.4 · §6（阶段三为主）
交付轮	SDAD、PRD	`65` `06` agentpm	方法论 L2–L4 · 块二 §2 §5

Day 9–22 必修 · docs → 手册

docs 真源	手册落点	学员消费
`02` Coze 八大模块	块二 §1	建立「编排平台是什么」
`52` ②竞品 + ③六大模块	块二 §1 + 五步法	做什么 / 不做什么
`13` 能力版图	块二 §1 各模块侧栏	按模块查
AgentPM + 7 阶段	块二 §2.1 + §3	跟练主线
`65` L2–L4	方法论 + 块二 §5	PRD / 派活 / 五件套
`22` M1–M11	块二 §1.11 · §6	工程 PM 选修

docs/22 三阶段工程 ≠ 学员七阶段交付。前者给讲平台的人；后者给用 AgentPM 交 PRD 的人 — 目录分开。

5. 菜单深度约定

层级	块一阶段二	块二 Agent
侧栏二级	学习单元（≈半天~1天）	模块 / 7阶段 / 模板大类
页内 H2	跟练步骤、检查点	模块子能力（如 1.4.1 切片）
outline x.y.z	写稿 checklist	深页锚点
docs/ 原文	不挂菜单	页脚「工程真源」

7 阶段：块二 §3 侧栏 1 项，页内 7×H2；阶段二 2.4 不重写正文。
Coze 八大模块：块二 §1 总览 + 六大模块各 1 侧栏项；发布/运营合并进 Agent 管理 + 进阶。

6. 侧栏深度目标

载体	侧栏二级约
阶段二	9 项（2.0–2.9）
块二 Agent	20+ 项
方法论	3–5 项

学员可见目录 = config.ts 侧栏 only。
每页写什么 → student-content-spec-v1（自用，不进侧栏）。

7. 新增场景 Agent 接入流程

text

1. §2 场景总览 加一行 + 新建 agent/scenarios/{slug}.md（AgentPM 已有 §2.1，不重复建）
2. 块二 §7 FAQ · 案例库 双链
3. 块一 / 跟营：加「选此场景 → 读 §2.x」双链（不改 §1 平台）
4. docs/ 内部真源链在场景页脚

手册架构约定 · V1 ​

1. 一句话分工 ​

2. 三角索引 ​

3. 五条不可违反规则 ​

4. docs/ 四轮 · 阶段二必修映射 ​

Day 9–22 必修 · docs → 手册 ​

5. 菜单深度约定 ​

6. 侧栏深度目标 ​

7. 新增场景 Agent 接入流程 ​

相关 ​

手册架构约定 · V1

1. 一句话分工

2. 三角索引

3. 五条不可违反规则

4. `docs/` 四轮 · 阶段二必修映射

Day 9–22 必修 · docs → 手册

5. 菜单深度约定

6. 侧栏深度目标

7. 新增场景 Agent 接入流程

相关