auto-sync: 2026-06-04 08:47:22

docs/design/11-context-layers-redesign.md

@@ -1,7 +1,7 @@
 # #11 上下文四层架构重新定位方案
 
-> 版本: v1.0  
-> 日期: 2026-06-03  
+> 版本: v2.0  
+> 日期: 2026-06-04  
 > 作者: 庞统（副军师）  
 > 状态: **待确认**  
 > 来源: 用户设计思路 + NAS 知识库调研（ClawTeam/Superpowers/GSD/Hermes/oh-my-claudecode）
@@ -137,45 +137,45 @@ Shared Memory → Boids Rules(仅 team>1) → Task → Context → Coordination
 - AGENTS.md 中的"对应 Skill"映射表 → **删除**（Skill discovery 靠 L3 的 description 匹配，不靠映射表）
 - AGENTS.md 中的详细协作规则 → **保留核心**，但操作手册级的细节移到 L3 Skill
 
-### 2.3 L2 引擎注入层 — "引擎流转所需的最小规则集"
+### 2.3 L2 引擎注入层 — "任务上下文 + 角色操作规范 + 硬约束"
 
-**定位**：只放**引擎需要注入才能让任务正常流转**的规则和约束。这是 Daemon/Spawner 在 spawn Agent 时动态拼装的，按场景精确注入。
+**定位**：BootstrapBuilder 在 spawn Agent 时动态拼装。包含**任务上下文** + **A 类操作规范全文**（按角色精确注入）+ **硬约束**。总量控制在 ~600 tokens。
 
-**来源**：`BootstrapBuilder` 代码 + `prompt_templates/` 目录。
+**来源**：`BootstrapBuilder` 代码 + L3 Skill 文件（A 类 Skill 由引擎直接读取注入全文）。
+
+**核心变化**：操作规范不再从 `prompt_templates/` 目录读取，而是**从 L3 Skill 文件读取**。BootstrapBuilder 通过 ROLE_SKILL_MAP 按角色精确注入对应的 A 类 Skill 全文。
 
 **放什么**：
-| 组件 | 内容 | 注入条件 |
-|------|------|---------|
+| 段落 | 内容 | 说明 |
+|------|------|------|
 | ① 任务上下文 | 黑板任务数据（title/description/must_haves/status） | 所有 spawn |
-| ② 项目背景 | project_context.yaml | 所有 spawn |
-| ③ 状态流转约束 | "完成后必须标 review"、"产出物不能空"、"handoff ≥ 50 字" | executor |
-| ④ 前序信息 | depends_on 产出摘要 + handoff comment | executor（有依赖时） |
-| ⑤ Guardrail 安全红线摘要 | 当前任务的 guardrail 检查结果 | executor（有红线触发时） |
-| ⑥ 广播认领规则 | 三级响应（claim/observe/NO_REPLY）+ API 端点 | broadcast 场景 |
-| ⑦ 审查流转规则 | review verdict 类型、rebuttal 流程 | reviewer 场景 |
+| ② 前序产出 | depends_on 产出摘要 + handoff comment | executor（有依赖时） |
+| ③ 角色操作规范全文 | A 类 Skill 全文（按角色精确注入） | 通过 ROLE_SKILL_MAP |
+| ④ 硬约束 | 状态流转约束（完成后标 review、产出物非空、handoff ≥ 50 字） | executor |
+
+**ROLE_SKILL_MAP（角色→A类 Skill 映射）**：
+| spawn 角色 | 注入的 A 类 Skill |
+|-----------|-------------------|
+| `executor` | `blackboard-executor` |
+| `reviewer` | `blackboard-reviewer` |
+| `reviewer-simayi` | `blackboard-reviewer-simayi` |
+| `reviewer-pangtong` | `blackboard-reviewer-pangtong` |
+| `planner` | `blackboard-planner` |
+| `claim` | `blackboard-claim` |
 
 **不放什么**：
 - ❌ 角色身份（"你是张飞，擅长编码"）→ L1 SOUL.md
-- ❌ 操作手册（"先读黑板、再动手、写产出、标 review"）→ L3 Skill（`blackboard-executor`）
-- ❌ 审查方法论（"挑战者思维"、"先理解目标再判断"）→ L3 Skill（`review-quality`）
-- ❌ 规划方法论（"理解需求→拆解→动态调整"）→ L3 Skill（`task-planning`）
-- ❌ 经验/知识 → L3 Skill（`trial-and-error-patterns` 等）
-- ❌ Boids 协作规则 → L3 Skill（`team-collaboration`）
-- ❌ 元认知自评 → L3 Skill（`metacognition`）或 L0 铁律
+- ❌ 方法论（"挑战者思维"、"Boids 协作"）→ L3 B/C/D 类 Skill（靠 Description 触发）
+- ❌ 经验/知识 → L3 D 类 Skill
+- ❌ `prompt_templates/` 目录 → **废弃**，操作规范从 Skill 文件读
 
-**核心变化（相比 05-context-layers.md）**：
-- **砍掉"操作规范"组件**（prompt_templates/{role}.md 整个角色模板）→ 移到 L3 Skill
-- **砍掉"审查协议"组件**（review_protocols/）→ 移到 L3 Skill
-- **砍掉"经验注入"组件**（experiences 表）→ 移到 L3 Skill
-- **L2 只留流转必须的结构化数据**：任务上下文 + 项目背景 + 状态约束 + API 端点
-
-**token 预算**：≤ 800 tokens（极简，只放数据+约束，不放方法论）
+**token 预算**：~600 tokens（任务上下文 ~200 + 操作规范 ~300 + 硬约束 ~100）
 
 **设计理由**：
-1. **和 ClawTeam 对齐**：ClawTeam 的 prompt 只放 Identity + Mission(intent/end_state/constraints) + Workspace + Task + Coordination Protocol，方法论在 Skill 里
-2. **L2 越薄越稳定**：引擎代码改动频率 > Skill 改动频率。L2 薄意味着引擎代码改动少
-3. **L3 可以随时更新**：extraDirs 重启即生效，不需要改代码
-4. **用户原话**："L2 只放和引擎相关的内容，比如如何让引擎能够正常流转的各种规则和约束"
+1. **A 类 Skill 引擎直接注入**：操作规范是每次执行必须遵守的，不能靠 Agent 自主触发，必须确定性注入
+2. **从 Skill 文件读而非 prompt_templates**：单一数据源，改 Skill 即生效，不需要维护两套
+3. **按角色精确注入**：executor 只读 blackboard-executor，不读 reviewer 规范，避免 context 浪费
+4. **L2 薄且稳定**：BootstrapBuilder 只做"读 Skill + 拼 context + 加约束"三件事，逻辑极简
 
 ### 2.4 L3 被动参考层 — "所有 Skill + 经验 + 知识"