Files
sanguo_moziplus_v2/skills/self-reflection-wisdom.md
T
2026-05-27 00:09:34 +08:00

3.0 KiB
Raw Blame History

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/endvs 需要适配。

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

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

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

检查清单

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