基本工作流

Forgexa 遵循结构化流水线，将需求转化为已部署的代码。

生命周期概览

需求 → 分析 → 计划 → 执行 → 门禁评审 → 合并

1. 提交需求

用户以自然语言提交需求。系统支持：

• 自由文本描述
• 验收标准
• 优先级（紧急、高、中、低）
• 附件和引用

2. AI 分析

点击 分析 后，AI 将：

1. 解析需求为结构化字段
2. 识别功能性/非功能性需求
3. 生成验收标准
4. 评估复杂度并建议工作项
5. 创建结构化规格说明

3. 生成计划

需求审批后，生成 计划，包含：

• 工作项 — 看板上的离散任务
• 执行节点 — 流水线阶段（设计、编码、测试、评审）
• 依赖关系 — 任务排序和前置条件

4. 执行

计划审批后：

1. 创建 执行图
2. 编排器 轮询就绪节点（依赖已满足）
3. 将节点分发到可用的 运行时守护进程
4. 守护进程在隔离工作空间中执行 AI Agent
5. 结果回报给服务器

5. 测试-修复循环

对于编码节点，系统自动：

1. 运行项目测试套件
2. 若测试失败 → 携带失败上下文重新调用 AI Agent
3. 最多循环 5 次迭代直到测试通过
4. 所有迭代记录在执行日志中

6. 质量门禁

执行完成后，计算跨 7 个维度的 门禁评分：

维度	权重	来源
测试通过率	25%	自动化测试结果
测试覆盖率	15%	代码覆盖率工具
静态检查	15%	Lint / 类型检查
安全性	20%	安全扫描结果
变更风险	10%	高风险文件变更检测
AI 评审	5%	AI 代码评审评分
需求覆盖度	10%	补充需求落实情况

根据加权评分：

• ≥ 85：自动合并（可配置）
• 60–84：需要人工评审
• < 60：阻断 — 需要返工

7. 合并

审批通过的变更通过自动创建的 Pull Request 合并到项目默认分支。

工作项状态

todo → in_progress → in_review → done
                ↘ cancelled

执行节点状态

pending → in_progress → completed
                      → failed → (重试) → pending
                      → cancelled