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

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

@@ -179,13 +179,13 @@ Shared Memory → Boids Rules(仅 team>1) → Task → Context → Coordination
 
 ### 2.4 L3 被动参考层 — "所有 Skill + 经验 + 知识"
 
-**定位**：所有和任务执行相关的内容都在这一层。通过 OpenClaw 的 `extraDirs` 机制，Skill header（name + description）自动加载到 Agent，Agent 根据任务需要自主 `read` 全文。
+**定位**：所有和任务执行相关的内容都在这一层。通过 OpenClaw 的 `extraDirs` 机制，Skill header（name + description）自动加载到 Agent。A 类 Skill 由引擎确定性注入全文，B/C/D 类 Skill 靠 Description 自主触发。
 
 **来源**：`~/.sanguo_projects/sanguo_mozi/skills/`（extraDirs 配置）+ moziplus 专用 Skill 目录。
 
-**放什么**：
+**Skill 分类体系**：
 
-#### A. 操作规范型 Skill（从 L2 角色模板降级）
+#### A. 操作规范型（6 个）——引擎直接注入全文，不靠 Description 触发
 
 | Skill | 来源 | 说明 |
 |-------|------|------|
@@ -196,23 +196,22 @@ Shared Memory → Boids Rules(仅 team>1) → Task → Context → Coordination
 | `blackboard-planner` | 原 `prompt_templates/planner.md` | 规划者：规划思维、终态定义 |
 | `blackboard-claim` | 原 `_build_claim_prompt` 三级响应 | 广播认领：三级响应（claim/observe/NO_REPLY）|
 
-#### B. 方法论型 Skill（从设计文档提升）
+#### B. 方法论型（4 个）——靠 Description 自主触发
 
 | Skill | 来源 | 说明 |
 |-------|------|------|
-| `team-collaboration` | 03-prompt-evolution Boids 规则 | Separation/Alignment/Cohesion/Boundary + 共享意识 |
 | `metacognition` | ClawTeam METACOGNITION_BLOCK | 置信度自评 + 升级机制 |
 | `scope-reduction-detection` | 03-prompt-evolution §8.2 | 反静默降级检查（executor 自检 + reviewer 复检）|
 | `plan-approval-workflow` | 03-prompt-evolution §8.3 | 复杂任务先计划后执行 + 5分钟异议窗口 |
+| `team-collaboration` | 03-prompt-evolution Boids 规则 | Separation/Alignment/Cohesion/Boundary + 共享意识 |
 
-#### C. 审查协议型 Skill（从 L2 review_protocols 提升）
+#### C. 审查协议型（1 个）——靠 Description 自主触发
 
 | Skill | 来源 | 说明 |
 |-------|------|------|
 | `review-quality` | 蒸馏扫描②③ | 4 个评审质量模式 |
-| `code-review` | 已有 Skill | 代码审查完整流程 |
 
-#### D. 经验型 Skill（从 experiences 表提升）
+#### D. 经验型（3 个）——靠 Description 自主触发
 
 | Skill | 来源 | 说明 |
 |-------|------|------|
@@ -220,47 +219,26 @@ Shared Memory → Boids Rules(仅 team>1) → Task → Context → Coordination
 | `proven-practices` | 蒸馏扫描③ | 9 个成功最佳实践 |
 | `self-reflection-wisdom` | 蒸馏扫描⑥ | 3 个自我反思模式 |
 
-#### E. 任务执行型 Skill（已有）
+#### 路由层：skill-router
 
 | Skill | 说明 |
 |-------|------|
-| `plan-act-verify` | 非平凡任务执行流程 |
-| `code-review` | 代码审查 |
-| `data-acquisition` | 数据获取 |
-| `deployment-infra` | 部署 |
-| `quant-backtest` | 量化回测 |
-| `subagent-delegation` | 任务委派 |
-| ...（42 个现有 Skill） | |
+| `skill-router` | 路由速查表，按三个分类组织（操作规范/方法论/经验参考），Agent 先读此表再定位具体 Skill |
 
-#### F. 知识注入型 Skill（新增）
-
-| Skill | 说明 |
-|-------|------|
-| `wiki-knowledge-{domain}` | 按领域注入 wiki-vault 知识（如量化策略、vnpy 框架等）|
-
-**Skill Header 格式**（遵循 OpenClaw SKILL.md frontmatter）：
-
-```yaml
----
-name: blackboard-executor
-description: |
-  黑板执行者操作规范。当 Agent 通过黑板执行任务时使用。
-  包含：能力列表、执行纪律、产出标准、交接责任。
-  触发词：executor、执行、黑板执行、task execution、blackboard executor。
-  触发条件：收到 moziplus 投递的执行任务时。
----
-```
+**Skill Description 编写规范**（所有 Skill 必须）：
+- 一句话定位（这个 Skill 是什么）
+- 触发场景（什么时候该用）
+- 核心能力（能解决什么问题）
+- 触发词（5-8 个关键词）
+- 不触发词（什么场景不该用）
+- 总长 ≤ 200 字
 
 **设计理由**：
-1. **用户原话**："所有和任务执行相关的所需的技能都放在这一层，因为 openclaw 有关键词动态加载的机制"
-2. **和 Superpowers 对齐**：Superpowers 的 14 个 Skill 全部是这种模式——Skill header 定义触发条件，Agent 自主匹配
-3. **经验沉淀变成 Skill**（和 Hermes 对齐）：不是单独的 experiences 表，而是提炼成 Skill。"trial-and-error-patterns" 比 "119 条 experiences 按 tag 匹配" 更实用
-4. **重启即生效**（用户原话）："这一层是 extra dir 的形式补充 L1 的，所以可以随时重启来加载"
-
-**不放什么**：
-- ❌ 铁律（GATE 规则）→ L0
-- ❌ 身份（我是谁）→ L1 SOUL.md
-- ❌ 引擎流转数据（任务上下文、状态约束）→ L2
+1. **A 类引擎直接注入**：操作规范是任务流转的必须品，不能靠 Agent 自主触发，必须确定性注入
+2. **B/C/D 类靠 Description 自主触发**：方法论、审查协议、经验是辅助性的，Agent 按需加载
+3. **skill-router 解决发现难题**：Skill 数量增多后，Agent 通过路由速查表快速定位
+4. **经验沉淀变成 Skill**（和 Hermes 对齐）：不是单独的 experiences 表，而是提炼成 Skill
+5. **重启即生效**：extraDirs 机制，不需要改代码
 
 ---