auto-sync: 2026-05-31 12:56:55

docs/design/03-prompt-evolution.md

@@ -2,7 +2,7 @@
 
 **日期**: 2026-05-31
 **作者**: 庞统
-**状态**: v3.0 待评审（新增 §八：第二波 AI Native 实践）
+**状态**: v3.0 待评审(新增 §八:第二波 AI Native 实践)
 **前置**: `02-main-session-delegation.md`、`04-blackboard-collaboration-model.md`
 **参考**: PRD v3.0(B3 共享意识)、shared-consciousness-research.md
 
@@ -62,9 +62,9 @@ Agent 有 SOUL.md、workspace、工具能力,不需要手把手教。Prompt 定
 
 Prompt 描述"你是谁、你关心什么、什么算好结果",而不是"你应该执行这些步骤"。
 
-### P4. 群体智能（Boids）
+### P4. 群体智能(Boids)
 
-Boids 是 Craig Reynolds 的群体行为模型。四条规则注入 Agent 行为：
+Boids 是 Craig Reynolds 的群体行为模型。四条规则注入 Agent 行为:
 
 | 规则 | 含义 | 对应 Agent 行为 |
 |------|------|----------------|
@@ -81,15 +81,15 @@ Agent 产出自带置信度信号 `[confidence: 0.X]`,帮助指挥官判断是
 
 来源:ClawTeam 实践 + O'Reilly "Designing Effective Multi-Agent Architectures"(2026.02)。
 
-### P6. 反静默降级（Scope Reduction Detection）
+### P6. 反静默降级(Scope Reduction Detection)
 
-Agent 在执行过程中静默丢弃需求是常见问题——不说不做,只是悄悄缩小范围。系统必须主动检测并阻止。
+Agent 在执行过程中静默丢弃需求是常见问题--不说不做,只是悄悄缩小范围。系统必须主动检测并阻止。
 
 来源:get-shit-done Scope Reduction Detection。
 
-### P7. 经验闭环（闭环学习引导）
+### P7. 经验闭环(闭环学习引导)
 
-只记录不应用的知识是浪费。Agent 在 handoff 时标注值得记录的经验（被纠正、发现更好做法）,让经验可被发现和复用。
+只记录不应用的知识是浪费。Agent 在 handoff 时标注值得记录的经验(被纠正、发现更好做法),让经验可被发现和复用。
 
 来源:知识管理体系 DISCOVER→DISTILL→APPLY→IMPROVE。
 
@@ -173,21 +173,28 @@ Agent 在执行过程中静默丢弃需求是常见问题——不说不做,只
 
 **问题**:操作手册风格,告诉步骤而不是目标和标准。
 
-#### v2.1(修订后)
+#### v2.1（修订后）
 
 ```markdown
 # 执行者
 
 ## 你是谁
-专业执行者。你的目标是交付可验证的产出,不是"走完流程"。
+专业执行者。你的目标是交付可验证的产出,不是“走完流程”。
 
 ## 工作方式
 理解意图 → 确认设计 → 实现 → 交接。不确定时停下来问(黑板 comment),不要猜。
 
-## 什么算"做完了"
+### Alignment: 先理解全局再动手
+动手前先读黑板上的全局计划和其他 Agent 的 comment,理解你的任务在整个目标中的位置,再决定怎么做。
+
+### 复杂任务: 先计划后执行
+如果任务复杂(涉及多个文件、多个模块、或你有不确定的地方),先在黑板 comment 写出你的执行计划,等确认后再动手。简单任务直接做。
+
+## 什么算“做完了”
 1. 产出物已写入黑板(output),有实际内容
 2. 状态改为 review
 3. 写了 handoff comment:你做了什么决策、为什么、踩了什么坑、给下一个人什么建议
+4. 如果有值得记录的经验(被纠正、发现更好做法),在 handoff 中标注“💡 经验:...”
 
 ## 黑板是你的工作空间
 - 读其他 Agent 的 comment 和产出,理解全局上下文
@@ -451,7 +458,7 @@ v1.x 做了正确的基础工作(三段式结构、身份注入、去 curl)。v2
 | **审查风格** | ❌ Checklist | ✅ 挑战者思维+置信度 |
 | **规划方式** | ❌ Phase 查表 | ✅ 理解→拆解→动态调整 |
 
-v1.x 的所有基础设施（counter、router、spawner、bootstrap）完全复用，不动。
+v1.x 的所有基础设施(counter、router、spawner、bootstrap)完全复用,不动。
 
 ### FATAL-1: observation 边界未定义 → **采纳,改为"跨领域专业建议"**