---
name: self-reflection-wisdom
description: >-
  Agent 自我反思和经验沉淀的最佳实践：自我纠正、诚实边界、调研落地。
  在完成任务后反思、或做跨项目调研时触发。
---
# Self-Reflection Wisdom

> 来源：从三国团队 21 条经验声明中蒸馏（卡片 3、15）

## 适用场景

- 完成代码评审后，怀疑自己的判断是否正确
- 做跨项目调研后，需要将发现转化为可落地的架构改进
- 任务交付后，复盘"我哪里做错了 / 可以做得更好"
- 团队成员指出你的错误时，决定如何回应

## 模式清单

### 模式 1：主动自我纠正，保留审计轨迹

评审或执行中发现自己之前的判断有误时，立即修正并明确标注，而非静默修改。修正时引用具体证据（设计文档章节、代码行号），说明原判断为什么错、正确判断是什么。保留修正前后的对比，让团队看到推理过程。

> **Evidence**: 卡片 3 — 庞统和司马懿在同一次评审中都做了自我纠正，修正邮件明确标注"修正 1/修正 2"，保留了审计轨迹。

### 模式 2：诚实边界 — "不能"比"绕弯子"更有价值

当无法给出确定答案时，直接说"不能/不知道"，然后说明在现有约束下能做什么。不要用相关信息堆砌来回避核心问题。用户反复追问同一问题时，往往是回答者在绕弯子的信号。

> **Evidence**: 卡片 3 — 评审者翻回设计文档交叉验证发现误判；庞统反思"你说得对，我一直在说废话"，将问题简化为三个核心问题。

### 模式 3：调研产出必须有落地映射

跨项目调研的对照表不能停留在"可借鉴"层面。每条发现必须标注：可直接复用的模式（附优先级）、需要适配的部分、暂不需要的部分。格式建议：优秀实践 / 来源 / 核心模式 / moziplus 可借鉴点（含优先级）。

> **Evidence**: 卡片 15 — 庞统调研三个项目后，部分条目只停在"可借鉴"层面，没有明确"怎么做"。正确做法是标注可直接复用（如 Lifecycle Hooks → on_node_start/end）vs 需要适配。

### 模式 4：翻回设计文档做交叉验证

当评审中遇到不确定的判断时，不要凭记忆或直觉下结论。翻回设计文档（PRD/架构文档）逐条对照，用文档的明确编号（如 §B1/B2/B3）定位。交叉验证是发现误判的最有效手段，比"再想想"更可靠。

> **Evidence**: 卡片 3 — 庞统重新读设计文档后发现代码遗漏了 §B2 实现；司马懿在庞统修正后承认"你说得对，我判断错了"。

## 检查清单

- [ ] 评审/执行完成后，是否回溯检查了自己的判断？
- [ ] 发现误判时，是否主动发出修正并标注了"修正"？
- [ ] 修正是否引用了具体证据（文档章节、代码行号）？
- [ ] 调研产出中，每条发现是否标注了落地优先级？
- [ ] 不确定的问题是否直接说了"不能"，而非绕弯子？
- [ ] 关键判断是否翻回设计文档做了交叉验证？
