3.0 KiB
3.0 KiB
name, description
| name | description |
|---|---|
| self-reflection-wisdom | 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 实现;司马懿在庞统修正后承认"你说得对,我判断错了"。
检查清单
- 评审/执行完成后,是否回溯检查了自己的判断?
- 发现误判时,是否主动发出修正并标注了"修正"?
- 修正是否引用了具体证据(文档章节、代码行号)?
- 调研产出中,每条发现是否标注了落地优先级?
- 不确定的问题是否直接说了"不能",而非绕弯子?
- 关键判断是否翻回设计文档做了交叉验证?