AI DevFlow

AI DevFlow 把 CodeFree-O、SRDCloud、OpenSpec、Maven 质量门禁和 Git/MR 流程组合为可复用的 Spring Boot 研发闭环。

项目文档

• 项目背景与产品定位
• 功能介绍
• 架构与设计方案
• 技术实施方法
• 开发约定

两种入口

# 存量项目接入：先预检，确认后应用
npx ai-devflow init

# 新项目创建：编排 Spring Initializr 后安装治理能力
npx ai-devflow create billing-service --stack spring-boot --profile company-java

init 默认只展示变更计划并请求确认；自动化场景可使用 --yes。已有文件不会被静默覆盖，受管文件被人工修改后会报告冲突。

日常研发

cd billing-service
codefree-o

进入 CodeFree-O 后执行：

/devflow 新增账户余额查询能力

本地维护仍使用 CLI：

npx ai-devflow verify
npx ai-devflow status
npx ai-devflow report
npx ai-devflow openspec update
npx ai-devflow quality update

/devflow 是唯一研发任务入口，不提供 npx ai-devflow run。它在 CodeFree-O 中查询 SRDCloud 工作项与知识，生成并严格验证 OpenSpec 五产物，完成实现和 Maven 门禁后创建 MR、邀请评审。运行证据保存在 .devflow/runs/，可视化报告保存在 .devflow/report/。

CodeFree-O 同时获得以下项目级能力：

• Plugin：保护受管文件、拒绝质量绕过命令、记录工具事件。
• Tool：创建与推进状态、调用真实 OpenSpec、执行可信验证、登记证据、提交候选记忆。
• Agent：规划、实现、独立审查三种职责与不同权限。
• Command：DevFlow 命令，以及 OpenSpec 官方生成的全部 opsx-* 命令。
• Skill：研发闭环、SRDCloud 上下文、验证、MR 评审，以及 OpenSpec 官方 Skill。
• Hook：提交信息校验、提交前快速门禁，以及推送前分支/保护分支/非快进校验和完整门禁。

接入安全

• init 先扫描 Maven 模块、Git、Maven Wrapper、质量插件、CodeFree-O 与受管文件，再展示计划。
• 文件按事务写入；中断后下次 init 自动恢复，失败时恢复原字节。
• 既有 AGENTS.md、codefree.json、Git Hook 与 .gitignore 采用保留或标记块合并。
• 受管文件通过 SHA-256 识别；初始化和每次验证都会检查摘要，本地改动不会被升级静默覆盖。
• 存量项目基线失败时记录为 DEGRADED，不伪造成功；新项目基线失败时不发布目标目录。

三层组合

company-standard 组织规则包负责安全、Git 与质量底线；spring-boot Adapter 负责脚手架、编译、测试和验证；company-java Profile 负责项目默认值。项目级 Spec 单独保存在 .devflow/specs/project.json，不复制或改写组织规则。

当前范围

• Node.js 20 及以上。
• CodeFree-O 作为唯一 Agent 执行面；SRDCloud 鉴权和 MCP 连接由 CodeFree-O 提供。
• OpenSpec 使用 devflow-prd 五产物 schema：prd → proposal → specs → design → tasks。
• 0.2.0 技术栈仅支持 Spring Boot；版本与生成参数从 Spring Initializr 元数据读取。
• 组织规则包为 company-standard，项目 Profile 为 company-java。