PlanGate：AI编程智能体的门控工作流框架

PlanGate是面向生产级开发的AI编码智能体门控工作流框架，核心机制为"计划未经批准不得实施"，旨在结构化管理从需求到交付的完整开发流程，解决AI编码中计划与实现脱节、审批边界模糊、验证事后化等核心问题。

AI编码工具普及提升了开发效率，但也暴露出新风险：AI实现往往跑在计划前面，审批和责任边界模糊，验证成为事后补救，上下文和评估标准过度依赖会话或个人记忆，完成判断依据散落在PR和对话记录中。PlanGate为此诞生，将AI置于具有审批边界、明确产出物和标准验证流程的开发约束框架（harness）中运行。

PlanGate的核心设计哲学是"计划未经批准，AI一行代码也不能写"。与传统Harness工程的区别在于：

• 计划先行：批准前绝不开始实现
• 边界明确：清晰定义批准、驳回、重新执行的边界
• 成果物沉淀：将计划、任务、测试视角作为产出物留存
• 验证内嵌：实施后必须进行验收检查、审查和交接
• 知识固化：将判断标准和上下文固定在文件中，而非依赖个人记忆

PlanGate采用多层级门控机制：

• C-3门：人类审查员对AI生成的计划进行审批，通过后AI才能进入实现阶段
• C-4门：实现完成后代码需通过PR审查
• 验证层级：L-0（AI自验证）、V-1～V-4（从基础功能测试到集成测试的多级验证体系）

工作流结构

1. 作业上下文创建：每个任务有独立目录docs/working/TASK-XXXX/
2. 计划生成与审查：AI根据PBI生成plan、todo和test-cases，自我审查或外部AI审查
3. 人类审查与门控执行：人类审核计划后AI获执行权限

状态持久化

将状态转移到文件系统，任务目录包含plan.md（计划）、review.md（审查记录）、verification.md（验证结果）、handoff.md（交接文档），带来可审计性、可恢复性、可协作性和知识积累的好处。

v7混合架构

引入Workflow、Skill、Agent三层分离：

• Workflow层：定义流程编排和门控规则
• Skill层：封装可重用的能力单元
• Agent层：执行具体任务的智能体实例

多工具支持

支持Claude Code和Codex CLI并用：

工具	入口文件	专用配置
Claude Code	CLAUDE.md	.claude/
Codex CLI	AGENTS.md	.codex/
共用	docs/ai/project-rules.md	docs/, scripts/

采用建议

渐进式策略：

1. 阶段一：试点项目使用C-3计划批准
2. 阶段二：引入验证层级和状态持久化
3. 阶段三：扩展到多项目，建立共享Skill库
4. 阶段四：采用v7完整架构

总结

PlanGate是AI辅助开发从"个人工具"向"团队协作框架"演进的尝试，通过门控机制、状态持久化和多层级验证解决核心问题，让团队享受AI效率同时保持对开发过程的控制和信心。