开源生态前沿资讯

拒绝幻觉:资深工程师开源 Claude Code 与 Cursor 的三阶段门禁工作流

约 3 分钟阅读

AI最前沿 88Z.ai 11 月 20 日消息,拥有超过 4500 小时 AI 编程经验的工程师 Vaibhav 开源了一套针对 Claude Code 和 Cursor 的工作流,通过“计划-批判-就绪”三道状态门禁,将复杂功能返工率降低 80% 以上。该方案强制 Agent 在写入代码前完成架构对齐与对抗性审查,解决了 AI 在多文件修改中易出现的逻辑混乱问题。

消息要点

  • 核心原则:禁止在无状态门禁下允许 Agent 直接修改业务代码
  • 三阶段门禁:Plan(只读规划)、Critique(对抗审查)、Readiness(验证后解锁写入)
  • 实际成效:复杂功能返工率降低 80% 以上,适用于 Claude Code 和 Cursor
  • 资源获取:全套工作流已在 GitHub 仓库 my-ai-coding-workflow 开源
my-ai-coding-workflow 仓库中的三阶段门禁流程图示
my-ai-coding-workflow 仓库中的三阶段门禁流程图示

背景与痛点:为何 AI 编程容易失控

在 Reddit r/ClaudeCode 社区获得广泛关注的实战分享中,资深后端工程师 Vaibhav 指出,尽管 Claude Code 和 Cursor 被视为提升效率的神器,但许多开发者在面对超过三个文件的修改任务时,常遭遇 AI 胡编乱造、代码结构越改越乱的困境。Vaibhav 基于每日高强度使用 AI 编程 6 小时、累计超 4500 小时的实践经验,认为核心问题在于缺乏对 Agent 行为的状态约束。他主张永远不应在没有明确状态门禁的情况下,允许 AI 代理直接修改业务代码,否则极易导致隐性耦合和边界遗漏。

核心机制:.claude/ 目录下的三阶段状态机

为了解决上述问题,Vaibhav 将其打磨两年的工作流封装在 .claude/ 目录中,设计为一台严格的三阶段状态机。第一道门是“Plan(架构对齐)”,在此阶段,Agent 被强制限制为只读模式,仅能扫描相关模块,并输出包含明确文件边界、接口签名及不变式约束的方案文档,严禁调用任何写文件工具。第二道门是“Critique(对抗挑刺)”,系统会拉起一个独立的审稿子上下文,模拟“冷酷的资深架构师”视角,对前一阶段的方案进行攻击性审查,专门识别隐式耦合、边界遗漏和过度设计等潜在风险。

执行流程:从就绪检查到权限解锁

第三道门称为“Readiness(就绪放行)”。只有当前两阶段的方案顺利通过批判性审查,并且明确了具体的验证单元测试命令后,系统才会解锁代码写入权限。这种看似“慢半拍”的门禁机制,实际上通过前置的风险控制,确保了后续代码生成的准确性与稳定性。Vaibhav 的数据显示,依靠这三道门禁,他将复杂功能的返工率降低了 80% 以上。该全套工作流已在 GitHub 仓库 my-ai-coding-workflow 中开源,供开发者参考集成。

88Z 观察

Vaibhav 的工作流揭示了一个关键趋势:AI 编程的价值重心正从“生成速度”转向“控制精度”。传统的 Prompt 工程往往侧重于如何更好地描述需求,而此类基于状态机的门禁机制则引入了软件工程中的严谨性,将 AI 视为需要严格监管的执行者而非全知全能的合作者。对于团队而言,直接复制该仓库可能并非最佳路径,但其核心理念——即在写入前强制进行独立的架构审查与测试规划——值得集成到现有的 CI/CD 或开发规范中。开发者应关注如何在保持敏捷的同时,通过结构化约束抵消大模型的概率性缺陷。

资料来源与整理说明

本文由 AI最前沿通过 AI 辅助整理公开资料。产品能力与开放范围按发布方说明转述,未将其视为本站实测或独家采访结论。

  1. @mylifcc原始资料发布于

以上日期为原始资料发布日期;标题下方日期为本文在 AI最前沿的发布时间。

相关阅读

全部资讯
Ai最前沿