SuperAPI AI 工具集

Software Factory Workflow

编程与开发

查看项目

更新于 11-13 20:13

技能介绍

Software Factory Workflow 是一套系统化的软件开发方法论,核心是用 5 个专职智能体组成带反馈回路的线性流水线,把零散想法逐步加工为经过测试与验证的软件。

用途 该工作流用于从想法启动新软件项目、把用户需求转化为已实现功能、建立可重复的开发流程、协调多名开发者或 AI 智能体之间的协作,并通过验证与反馈循环保障质量。

五智能体流水线

  1. Refinery:输入为原始想法、草图与描述,输出产品需求文档(PRD),主要活动包括解析输入、提取需求、编写用户故事、生成界面原型与验收标准。
  2. Foundry:输入 PRD,输出技术蓝图,负责设计架构、选择技术栈、定义数据模型与 API。
  3. Planner:输入技术蓝图,输出工作订单,负责任务拆解、依赖映射、优先级排序与执行计划。
  4. Assembler:输入工作订单,输出实现代码,负责写代码、写测试、运行测试、编写文档并产出实现报告。
  5. Validator:输入实现成果,输出验证报告与反馈,对照 PRD 核验需求、运行测试、收集用户反馈、识别问题并形成改进回路。

目录结构与版本约定 原始想法放在 project-idea/(index.md 为事实来源,amendments/ 可放补充想法)。项目文档放在 project-docs/,其中 prd/ 存放 Refinery 输出的 prd-v{N}.md 与 prd-latest.md,blueprint/ 存放 Foundry 输出,work-orders/ 存放 Planner 输出,validation/ 存放 Validator 输出;实现代码位于 src/ 并由 Git 版本管理。各阶段以递增版本号命名,并保留 latest 副本作为下游输入。

使用方式 通过命令逐阶段推进:"Run Refinery"(读取 project-idea/ 生成下一版 PRD)、"Run Foundry"(读取 prd-latest.md 生成蓝图)、"Run Planner"(读取 blueprint-latest.md 生成工作订单)、"Run Assembler"(读取 work-orders-latest.md 在 src/ 中实现)、"Run Validator"(读取 PRD 与实现生成验证报告)。扩展命令包括 "Add feature: X"(向 PRD 新增功能并触发全流程)、"Fix WO-XXX"(重新实现指定工作订单)、"Iterate until green"(循环实现直至全部测试通过)、"Debug WO-XXX"(排查失败的工作订单)、"Test WO-XXX"(运行指定工作订单的测试)。

协调模式 支持四种协调方式:顺序模式(适用于全新项目、需求清晰、单线开发);迭代模式(按功能集分冲刺,适用于敏捷开发与用户反馈驱动的场景);并行模式(后端、前端多轨并行,最后由 Validator 做集成验证,适用于多独立工作流与较大团队);持续模式(所有智能体持续循环,适用于成熟产品与持续交付)。

阶段划分 需求阶段(Refinery,约 1–2 天)、设计阶段(Foundry,约 1–2 天)、规划阶段(Planner,约 0.5–1 天)、实现阶段(Assembler,约 3–4 周)、验证阶段(Validator,实现期间持续并在末尾 2–3 天集中进行)、按需精化阶段(全部智能体经反馈回路参与)。上述时长为文档中针对中型项目的示例估计。

反馈回路 Validator 的发现会回流至前序环节:向 Refinery 反馈缺失或需澄清的需求;向 Planner 反馈新增缺陷修复与功能工作订单及优先级调整;向 Foundry 反馈架构缺口与技术选型复审。循环持续直至验证通过。

成功度量 文档给出吞吐(小功能从想法到部署目标少于 2 周、每周完成工作订单数、PRD 审批时间)、质量(首次实现即满足需求目标高于 85%、验证中发现的严重缺陷目标每功能少于 2 个、测试覆盖率目标高于 80%、用户满意度目标高于 4.0/5)与效率(返工率)等指标。

适用场景与限制 适用于从想法起步的新项目、需求到实现的转化、流程规范化及多智能体协作。文档中的示例(协作任务管理器)含具体技术选型与代码,仅为演示,并非本工作流的强制约束。除上述目录结构、命令与阶段约定外,具体工具集成方式、许可与收费信息暂未提供;成功度量中的数值为文档给出的目标值,并非保证效果。