概念解析

什么是 AI 编程工程工作流

AI 能写出代码,但写不出工程纪律。AI 编程工程工作流把「能写代码的 AI」改造成「可交付的工程师」——用结构化流程约束每个环节,用质量门禁守住每一道关口,让 AI 生成的不再是一次性代码,而是可维护、可追溯、可发布的软件。

问题:AI 编码缺少工程纪律

直接让 AI 写代码,效率很高,但稳定性堪忧。典型的「裸奔式 AI 编程」长这样:

  • 从想法直接跳到代码,跳过需求澄清,改到一半才发现方向错了。
  • 没有计划就动手,改动面越滚越大,收不了口。
  • 只写实现不写测试,「能跑」被当成「完成」。
  • 不审查、不验证就宣称交付,把风险推给下游。
  • 在 main 上直接提交,不关联 Issue,不留任何审计痕迹。

结果:代码看起来能跑,但不可维护、不可追溯、不可交付。短期省下的时间,会在长期的返工与事故里加倍还回去。

解法:一个公式,三条腿

工程纪律不是对 AI 的约束,而是对 AI 的增强。把「能写代码的 AI」放进工程化的容器里:

AI 编程工程工作流 = AI 助手 + 结构化流程 + 质量门禁

AI 助手

承担高强度执行——编写、重构、审查、跑命令,把人的精力留给关键决策。

结构化流程

需求澄清 → 计划制定 → 执行 → 交付检查,把工程循环固化成不可跳过的步骤。

质量门禁

build → test → fmt → clippy → pre-commit,全绿才算完成,杜绝「看着能跑」就交付。

四阶段模型:一个命令,跑完整个工程循环

工程循环被固化为四个连续阶段,每个阶段都有明确的产出与闸门,阶段间不可跳步:

  1. 01

    需求澄清

    从 open issues 提炼需求,产出结构化 Issue 与可机械验证的验收标准。

  2. 02

    计划制定

    生成可执行实现计划:改动面盘点、TDD 顺序与质量门禁承诺。

  3. 03

    执行

    TDD 红绿循环 + 子代理隔离开发,自动创建 PR 并附质量报告。

  4. 04

    交付检查

    流水线分析、Issue 分流、代码审查与闸门复核,全绿才合。

想深入了解每个阶段的执行细节与闸门证据?前往 gf-workflow 完整指南 →

两种技能来源,两种驾驶方式

工作流骨架恒定,执行引擎可切换。启动时自动检测技能来源并写入契约,跨会话沿用:

维度 Superpowers(全自动流水线) mattpocock(人工驾驶流水线)
触发模型 模型全自动触发 user-invoked 硬约束,✋ 暂停语义
Phase 1 澄清 brainstorming grilling/to-spec(只写本地)
Phase 2 计划 writing-plans /to-tickets(票据图 + blocking edges)
Phase 3 执行 SDD / executing-plans / 后台代理 /implement 逐票据(内部 /tdd
人的触点 2 个(Gate 2→3、Branch Finish) 5 个(✋×3 + 审批 + 确认)
主线 token 开销 ≈14k + subagent 扇出 ≈4.8k,不触发零消耗

两者皆未安装时,gf skills install 会硬阻断并给出安装引导,确保工作流始终有可用的执行引擎。

为什么需要工程纪律

工程纪律不是流程负担,而是把 AI 的生产力沉淀成组织资产:

可追溯

每次改动都关联 Issue、PR 与 CI 结果,审计链条完整。

可维护

TDD 与代码审查保证测试覆盖与可读性,长期可演进。

可交付

质量门禁保证每次合并都是全绿,发布可重复、可回滚。

可扩展

统一命令面覆盖 GitHub / GitLab / GitCode,多 Agent 平台一键接入。

给 AI 编程,上工程纪律。

MIT License · Rust 2024 · 支持 GitHub / GitLab / GitCode 三大平台