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

- 分类: 开源生态
- 发布时间: 2026-11-20T12:00:02.334Z
- 原始资料日期: 2026-11-20
- HTML: https://www.88z.ai/news/news-rejecting-hallucinations-senior-engi-20261120
- Markdown: https://www.88z.ai/news/news-rejecting-hallucinations-senior-engi-20261120.md
- 另一语言: https://www.88z.ai/en/news/news-rejecting-hallucinations-senior-engi-20261120.md

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

## 消息要点

- 核心原则：禁止在无状态门禁下允许 Agent 直接修改业务代码
- 三阶段门禁：Plan（只读规划）、Critique（对抗审查）、Readiness（验证后解锁写入）
- 实际成效：复杂功能返工率降低 80% 以上，适用于 Claude Code 和 Cursor
- 资源获取：全套工作流已在 GitHub 仓库 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 或开发规范中。开发者应关注如何在保持敏捷的同时，通过结构化约束抵消大模型的概率性缺陷。

## 资料来源

- [@mylifcc](https://x.com/mylifcc/status/2123582347023159572) (2026-11-20)

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