diff --git a/docs/design/11-context-layers-redesign.md b/docs/design/11-context-layers-redesign.md index 724f9f8..bd5039c 100644 --- a/docs/design/11-context-layers-redesign.md +++ b/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 + 经验 + 知识"