metacognition

Metacognition 是一套专为 AI 编码代理设计的强大质量控制框架。它强制代理在执行任务的关键时刻，如任务启动、阶段转换及错误恢复时，暂停并进行批判性思考评估。通过要求代理验证其对目标的理解、评估当前的假设并确认成功标准，此技能显著减少了幻觉、过度工程与范围蔓延的发生。对于需要编码助手保持严谨、测试优先且能适应变更需求的开发者来说，这是不可或缺的工具。

• 作为自动化的思考治理层，防止代理在未经核实的情况下贸然进入复杂的编码任务。

• 包含全面的任务理解清单，涵盖根本原因分析与症状修复的区别，以及对未知事项的辨识。

• 提供动态规则选择指南，根据当前任务类型仅加载相关文件（如 ai-development-guide.md 或特定语言规则），优化上下文窗口的使用。

• 具备严格的错误恢复协议，要求在寻求用户介入前，必须先记录阻塞问题并进行系统化的推理。

• 支持反模式识别，使代理能够在开发生命周期的早期阶段检测到常见的陷阱，如隧道视野、质量债务与不当的架构决策。

• 作为任何非微型编码任务或架构变更的阻塞性要求。

• 与 Cursor、Codex 及 Gemini CLI 环境中的 AGENTS.md 工作流标准无缝衔接。

• 输入：描述任务或错误状态的清晰提示。

• 输出：经过验证的执行策略、已加载的上下文规则列表以及签署后的完成总结。

• 实施限制：要求代理必须具备访问项目 .agents 目录的权限以进行规则探索。

• 鼓励“渐进式加载”，以保持 LLM 的上下文专注于即时的实施目标。