Agent Rigor – 阻止你的AI编程助手陷入死循环

Agent Rigor 是一个为自主编码代理设计的结构化框架，旨在解决AI编程助手在编码过程中常见的缺乏纪律问题。当AI代理在没有严格控制的情况下运行时，它们往往会跳过规划直接进入实现、编写看似合理但实际无法工作的代码，或者陷入“死循环”——一种修复导致更多修复的螺旋式困境。此外，它们可能会在会话之间遗忘学到的内容，或者由于一次加载过多指令而导致“上下文腐烂”。

Agent Rigor 通过一套强制性的协议、验证关卡和防找借口机制来应对这些问题。其核心理念包括：每个指令都必须是一个可验证的步骤，并带有退出标准（可操作协议）；要求AI提供证据而非仅凭“看起来正确”（实证主权）；确保代码库在已知良好状态之间转换，绝不提交损坏状态（原子状态转换）；以及主动预期并反驳代理用来跳过纪律的借口（防找借口）。

框架采用一个由三层上下文层级组成的渐进式披露系统，以防止上下文窗口崩溃。第一层是Apex内核（SYSTEM_CORE.md），它始终处于活动状态，负责路由和提供不可协商的规则。第二层是阶段指导（00_PHASE_DIRECTOR.md），仅在进入某个阶段时按需加载。第三层是技能协议（skills/*.md），提供深入的执行指南，仅在阶段指导请求时加载。

Agent Rigor 定义了六个操作阶段：1）任务综合（Mission Synthesis）：需求和规划，包括需求提炼和战略分解；2）执行引擎（Execution Engine）：实现和测试，使用收敛迭代和状态检查点；3）验证矩阵（Verification Matrix）：质量和审查关口，包括五边形审计和熵减少；4）认知持久性（Cognitive Persistence）：记忆和知识，通过上下文生命周期和结构制图；5）界面协议（Interface Protocols）：安全环境交互，包括有界观察和语义导航；6）自适应协议（Adaptive Protocols）：免疫系统，提供递归自我修正和范围控制。

快速开始很简单：在项目根目录运行安装脚本 curl -sSL https://raw.githubusercontent.com/MeherBhaskar/agent-rigor/main/install.sh | bash，然后告诉你的代理从读取 SYSTEM_CORE.md 并开始阶段1即可。Agent Rigor 是平台无关的，支持 Cursor、Claude Code、GitHub Copilot、Gemini CLI、Aider 等主流代理和IDE。

该项目托管在 GitHub 上，目前有2颗星和0个fork，采用纯 Markdown 编写，欢迎贡献以让代理更智能、更守纪律。