一句话总结:6A 工作流是一套专为 AI 编程助手(Cursor、Trae、Claude 等)设计的标准化开发流程,通过"文档先行 + 任务递归 + 范围收敛"三大核心理念,将 AI 从"代码生成器"升级为"按规范交付的开发伙伴"。
一、什么是 6A 工作流?
6A 工作流(6A Workflow)是由 AI 开发者社区提出的一套AI 辅助编程项目管理框架。它借鉴了传统软件工程的最佳实践,针对 AI 编程中常见的痛点进行了流程化设计。
核心理念
| 核心理念 | 含义 | 解决的问题 |
|---|---|---|
| 文档先行 | 不写清楚需求文档,不允许开始编码 | AI 需求理解偏差 |
| 任务递归 | 复杂任务层层分解到 AI 能稳定完成的原子级别 | AI 处理复杂任务时崩溃或质量差 |
| 范围收敛 | 明确边界,防止 AI "想当然"地扩展功能 | AI 过度设计、偏离需求 |
6 个阶段概览
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Align │───→│ Architect│───→│ Atomize │───→│ Approve │───→│ Automate │───→│ Assess │ │ 对齐 │ │ 架构 │ │ 原子化 │ │ 审批 │ │ 执行 │ │ 评估 │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ 模糊需求 共识文档 系统设计 原子任务 人工审查 执行结果 ↓ ↓ ↓ ↓ ↓ ↓ 精确规范 模块设计 任务拆分 迭代修改 编写代码 质量评估二、6A 工作流的作用
解决的核心痛点
| 传统痛点 | 具体表现 | 6A 解决方案 | 预期效果 |
|---|---|---|---|
| 需求理解偏差 | AI 生成的功能与预期不符,反复修改 | Align 阶段多轮澄清,形成共识文档 | 返工率降低 90% |
| 架构缺失 | 代码结构混乱,后期难以维护和扩展 | Architect 阶段强制先设计后编码 | 后期维护成本降低 70% |
| 复杂任务崩溃 | AI 面对大任务时输出质量差或中断 | Atomize 阶段递归拆分为原子任务 | 成功率提升 95% |
| 质量不可控 | 缺少边界检查、异常处理、测试 | Approve + Assess 阶段人工+自动把关 | 代码质量显著提升 |
| 团队协作混乱 | 交接困难,文档缺失 | 完整的文档体系,全程可追溯 | 交接时间减少 80% |
| AI 偷懒/幻觉 | AI 生成不完整或错误的代码 | 强制按流程走,每步都要文档 | 质量提升 80% |
适用场景
- ✅AI 辅助编程项目(Cursor、Trae、Claude、Copilot 等)
- ✅从需求到代码的完整开发流程
- ✅复杂功能模块的开发
- ✅团队协作的 AI 编程项目
- ✅需要高质量交付的生产级项目
三、6A 工作流的六个阶段详解
阶段 1:Align(对齐)— 需求澄清
目标:将模糊需求转化为精确规范
核心动作:
- 项目上下文分析:分析现有项目结构、技术栈、架构模式
- 需求理解确认:创建
docs/任务名/ALIGNMENT_[任务名].md - 智能决策策略:自动识别歧义,生成结构化问题清单
- 中断并询问:对不确定的问题主动中断并询问用户
- 最终共识:生成
CONSENSUS_[任务名].md
关键产出:
ALIGNMENT_[任务名].md— 需求对齐文档CONSENSUS_[任务名].md— 共识文档(含需求描述、验收标准、技术方案)
质量门控:
- 需求边界清晰无歧义
- 技术方案与现有架构对齐
- 验收标准具体可测试
- 所有关键假设已确认
阶段 2:Architect(架构)— 系统设计
目标:共识文档 → 系统架构 → 模块设计 → 接口规范
核心动作:
- 系统分层设计:基于共识文档设计整体架构
- 模块依赖梳理:明确各模块间的关系
- 接口契约定义:定义输入输出规范
关键产出:
DESIGN_[任务名].md— 设计文档,包含:- 整体架构图(Mermaid/PlantUML)
- 分层设计和核心组件
- 模块依赖关系图
- 接口契约定义
- 数据流向图
- 异常处理策略
设计原则:
- 严格按照任务范围,避免过度设计
- 确保与现有系统架构一致
- 复用现有组件和模式
质量门控:
- 架构图清晰准确
- 接口定义完整
- 与现有系统无冲突
- 设计可行性已验证
阶段 3:Atomize(原子化)— 任务拆分
目标:架构设计 → 拆分任务 → 明确接口 → 依赖关系
核心动作:
- 子任务拆分:将复杂任务拆分为独立原子任务
- 依赖关系管理:生成任务依赖图
- 契约定义:每个任务明确输入/输出/验收标准
关键产出:
TASK_[任务名].md— 原子任务清单,每个任务包含:- 输入契约:前置依赖、输入数据、环境依赖
- 输出契约:输出数据、交付物、验收标准
- 实现约束:技术栈、接口规范、质量要求
- 依赖关系:后置任务、并行任务
拆分原则:
- 复杂度可控,便于 AI 高成功率交付
- 按功能模块分解,确保任务原子性和独立性
- 有明确的验收标准,尽量可以独立编译和测试
- 依赖关系清晰,无循环依赖
质量门控:
- 任务覆盖完整需求
- 依赖关系无循环
- 每个任务都可独立验证
- 复杂度评估合理
阶段 4:Approve(审批)— 人工审查
目标:原子任务 → 人工审查 → 迭代修改 → 按文档执行
核心动作:
- 执行检查清单:
- 完整性:任务计划覆盖所有需求
- 一致性:与前期文档保持一致
- 可行性:技术方案确实可行
- 可控性:风险在可接受范围
- 可测性:验收标准明确可执行
- 最终确认清单:
- 明确的实现需求(无歧义)
- 明确的子任务定义
- 明确的边界和限制
- 明确的验收标准
- 代码、测试、文档质量标准
⚠️ 这是唯一必须人工介入的阶段,确保方案正确后再进入执行。
阶段 5:Automate(自动化执行)— 编码实现
目标:按节点执行 → 编写测试 → 实现代码 → 文档同步
核心动作:
- 逐步实施子任务:按任务依赖顺序执行
- 代码质量要求:
- 严格遵循项目现有代码规范
- 保持与现有代码风格一致
- 使用项目现有的工具和库
- 复用项目现有组件
- 代码尽量精简易读
- API KEY 放到
.env文件中,不要提交 Git
- 异常处理:
- 遇到不确定问题立刻中断执行
- 在 TASK 文档中记录问题详细信息
- 寻求人工澄清后继续
逐步实施流程(每个子任务):
执行前检查 → 实现核心逻辑 → 编写单元测试 → 运行验证测试 → 更新相关文档关键产出:
ACCEPTANCE_[任务名].md— 完成情况记录
阶段 6:Assess(评估)— 质量验收
目标:执行结果 → 质量评估 → 文档更新 → 交付确认
核心动作:
- 验证执行结果:
- 所有需求已实现
- 验收标准全部满足
- 项目编译通过
- 所有测试通过
- 功能完整性验证
- 实现与设计文档一致
- 质量评估指标:
- 代码质量(规范、可读性、复杂度)
- 测试质量(覆盖率、用例有效性)
- 文档质量(完整性、准确性、一致性)
- 现有系统集成良好
- 未引入技术债务
- 最终交付物:
FINAL_[任务名].md— 项目总结报告TODO_[任务名].md— 待办事项和缺少的配置
四、如何使用 6A 工作流
快速启动(以 Cursor / Trae 为例)
步骤 1:配置规则
Cursor 用户:
- 在项目根目录创建
.cursorrules文件 - 将 6A 工作流规则写入文件(见下方模板)
- 保存文件,重启 Cursor
Trae 用户:
- 在 Trae 设置中找到"自定义规则"或"Rules"配置
- 将 6A 工作流规则粘贴进去
- 保存配置
步骤 2:启动工作流
在 AI 工具对话框中输入:
@6A 开发一个[具体需求描述]例如:
@6A 开发一个用户登录功能,支持邮箱和密码验证,包含 JWT Token 生成步骤 3:跟随流程
AI 会自动按 6A 六个阶段逐步执行,你只需在关键节点(尤其是 Approve 阶段)进行确认和审查。
6A 工作流规则配置模板
# 6A 工作流 - AI 编程助手规则配置 ## 身份定义 你是一位资深的软件架构师和工程师,具备丰富的项目经验和系统思维能力。 ## 激活方式 用户输入 @6A 开头的内容即可启动工作流。 **激活时立即响应:6A 工作流已激活** ## 6A 工作流执行规则 ### 阶段 1: Align (对齐阶段) **目标**: 模糊需求 → 精确规范 - 分析项目上下文、技术栈、架构模式 - 创建 docs/任务名/ALIGNMENT_[任务名].md - 生成结构化问题清单,主动澄清歧义 - 生成 CONSENSUS_[任务名].md(需求、验收标准、技术方案) ### 阶段 2: Architect (架构阶段) **目标**: 共识文档 → 系统架构 - 创建 DESIGN_[任务名].md - 包含架构图、模块设计、接口契约、数据流图 ### 阶段 3: Atomize (原子化阶段) **目标**: 架构设计 → 原子任务 - 创建 TASK_[任务名].md - 每个任务含输入/输出契约、验收标准、依赖关系 ### 阶段 4: Approve (审批阶段) **目标**: 人工审查 - 检查完整性、一致性、可行性、可控性、可测性 - 等待用户确认后再继续 ### 阶段 5: Automate (自动化执行) **目标**: 按文档执行 - 创建 ACCEPTANCE_[任务名].md 记录进度 - 按依赖顺序执行,先写测试后写实现 - 遇到不确定问题立即中断 ### 阶段 6: Assess (评估阶段) **目标**: 质量验收 - 验证所有需求已实现、测试通过 - 生成 FINAL_[任务名].md 和 TODO_[任务名].md ## 技术执行规范 - 遵循项目现有代码规范 - API 密钥等敏感信息使用 .env 文件管理 - 测试优先:先写测试,后写实现 - 代码变更同时更新相关文档五、注意事项
⚠️ 关键注意点
| 类别 | 注意事项 | 说明 |
|---|---|---|
| 文档管理 | 确保每个阶段的文档完整准确 | 文档是后续阶段的基础,残缺会导致偏差 |
| 人工审查 | Approve 阶段必须认真审查 | 这是最后的纠错机会,跳过风险极高 |
| 项目规模 | 先小后大 | 建议先在小型项目上试用,熟悉流程后再用于大项目 |
| 工具权限 | 确保 AI 工具有文件读写权限 | 6A 工作流需要创建和管理文档 |
| 目录结构 | 项目需要有合适的目录结构 | 建议提前创建docs/目录 |
| 持续优化 | 根据项目特点调整模板 | 不同技术栈和团队需要定制化调整 |
| 异常处理 | 遇到不确定问题立即中断 | 不要勉强 AI 继续,记录问题并寻求人工澄清 |
| 安全规范 | 敏感信息使用.env管理 | API 密钥等绝不可硬编码 |
❓ 常见问题
Q:6A 工作流会不会太复杂?小项目能用吗?
A:初期可能感觉步骤多,但相比后期的返工和维护成本,绝对值得!小项目可以简化某些阶段,大项目则能充分发挥威力。
Q:适合什么规模的项目?
A:从小功能到大项目都适用。关键是根据项目规模灵活调整每个阶段的深度。
Q:如何说服团队使用?
A:先在一个小项目上试用,效果立竿见影,用数据说话最有说服力。
Q:AI 工具不支持自定义规则怎么办?
A:可以手动按 6A 流程与 AI 交互,在每个阶段明确要求 AI 输出对应的文档。
六、进阶技巧
1. 自定义模板
根据项目特点调整文档模板:
# 前端项目模板优化 - 增加组件设计文档 - 添加 UI/UX 设计规范 - 强化性能优化要求 # 后端项目模板优化 - 增加 API 设计规范 - 添加数据库设计文档 - 强化安全和权限要求2. 团队协作优化
# 多人协作最佳实践 - 指定文档 review 负责人 - 设置里程碑检查点 - 建立问题反馈机制 - 使用版本控制管理文档3. 质量把控清单
# 代码质量检查清单 - [ ] 代码规范检查(ESLint/Prettier) - [ ] 单元测试覆盖率达标 - [ ] 边界条件和异常处理覆盖 - [ ] 性能基准测试通过 - [ ] 安全漏洞扫描通过 - [ ] 代码审查(Code Review)完成4. 与其他方法结合
6A 工作流可以与5S 工作法(整理、整顿、清扫、清洁、素养)结合使用,效果更佳:
- 6A 确保架构和需求对齐
- 5S 确保代码执行顺序和注释规范
实战效果:返工率从 40% → 5%,开发效率提升 2-3 倍。
七、总结
6A 工作流的核心价值
| 价值点 | 说明 |
|---|---|
| 规范化 | 将 AI 的"自由发挥"转化为"结构化创造" |
| 可追溯 | 每个决策都有文档记录,便于复盘和交接 |
| 高质量 | 通过层层把关,确保交付物符合预期 |
| 低风险 | 早期发现问题,避免后期返工 |
| 可复用 | 沉淀的文档和模板可在团队内复用 |
立即行动建议
- 今天就试试:找个小项目体验一下 6A 工作流
- 配置规则:将 6A 规则配置到你的 AI 编程工具中
- 分享给同事:好东西要分享,一起告别低效开发
- 持续优化:根据团队特点调整流程和模板
- 建立标准:形成团队的项目管理规范
记住:工欲善其事,必先利其器。6A 工作流就是让 AI 从"熊孩子"变成"专业项目经理"的神器!