Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

devflow · 通用软件交付方法论 (Agent Skill Group)

一套与具体技术栈、业务无关的端到端软件研发方法论,沉淀为 17 个可被任意 AI Agent(QoderWork / Codex / Claude 等)加载调用的 skill。任何软件项目——Web 应用、内部工具、API 服务、移动端、数据系统——都能按这套流程从"模糊想法"走到"可交付成果"。默认收尾形态不止是"做出一个能跑的系统",而是交付一个完整规范的研发项目:从一个开发需求出发,自动产出立项、需求、计划、研发、测试、试运行、验收、结题到用户手册的整套研发项目文档。

黄金法则:先对话,后执行

任何开发动作之前,必须先完成需求对话(devflow-requirements)并形成书面《需求结论纪要》。不允许跳过对话直接写代码。这是整套方法论的第一原则。

快速开始

把 skills/ 下所有 devflow* 文件夹整体拷贝到你的 AI Agent 的 skills 目录即可。以 QoderWork 为例:

cp -R skills/devflow* ~/.qoderworkcn/skills/

拷贝后刷新 skill 列表,devflow 即可作为编排入口被触发(说"我要开发一个软件系统""按方法论开发""端到端交付流程"等)。其他 Agent 工具请拷贝到其对应的 skill 目录。

全流程管线(14 阶段 / 17 skill)

阶段 Skill 产出物
编排 devflow 总控入口,承载黄金法则与全局工程纪律
0 对话 devflow-requirements 需求结论纪要
1 需求 devflow-prd PRD 需求文档
2 产品 devflow-product-definition 角色 / 模块 / 功能矩阵
3 架构 devflow-architecture 架构设计 + 目录结构 + ADR
4 原型 devflow-prototype 页面原型 / 线框
5 设计 devflow-design-style 设计 token + 美术规范
6 技术栈 devflow-tech-stack 选型方法 + 版本锁定清单
7 规范 devflow-code-conventions 语言无关代码约束
8 前端 devflow-frontend-dev 页面 + 组件实现规范
9 后端 devflow-backend-dev API + 业务逻辑规范
10 数据库 devflow-database 数据建模 + 变更 SOP
11 测试 devflow-testing 分层测试策略 + 冒烟 + 报告
12 部署 devflow-deployment 部署流程 + 运维
13 文档 devflow-docs 交付文档(手册 / 报告 / 交接)排版·占位·校验
13+ 报告写作 devflow-report-writing docs 的深化配套:立项 / 可行性 / 计划书 / 研发·开发 / 测试 / 试运行 / 验收 / 结题报告 / 用户手册的逐章大纲 + 行文逻辑
★ 研发项目交付 devflow-rd-project 研发项目交付模式编排:把整套流程收束为一个完整规范的研发项目,定义全周期文档全集(立项→需求→计划→研发→测试→试运行→验收/结题→交付使用)+ 完整性自检表

阶段可并行:产品定义 / 架构 / 原型 / 设计 / 技术栈 / 数据库可在 PRD 确定后并行推进;前后端开发在数据模型和约定确定后并行。

全局工程纪律(所有子 skill 共同遵守)

  • 文档先行:每阶段产出物落盘,经确认再进入下一阶段。
  • 事实落盘:项目具体事实(技术栈版本、路径、命名、约定)写进《项目事实文件》(如 DEVELOPMENT_GUIDE.md / AGENTS.md),而非塞进通用方法论。
  • 依赖方向单一:分层清晰,禁止循环依赖。
  • 边界即校验:外部输入、跨层调用一律先校验。
  • 写操作要原子:多表 / 多步写入用事务。
  • 可追溯:关键流程写操作留痕(只增不改不删)。
  • 不臆造:未知信息用 XXX 占位,绝不瞎编事实性数据。

目录结构

devflow-agent-skills/
├── README.md
├── LICENSE                 # Apache-2.0
├── .gitignore
└── skills/
    ├── devflow/SKILL.md            # 编排入口
    ├── devflow-requirements/SKILL.md
    ├── devflow-prd/SKILL.md
    ├── ...(共 17 个)
    ├── devflow-docs/SKILL.md
    ├── devflow-report-writing/SKILL.md
    └── devflow-rd-project/SKILL.md  # 研发项目交付模式编排

研发项目交付模式(默认收尾形态)

devflow-rd-project 把整套方法论从"做出一个能跑的系统"升级为"交付一个完整规范的研发项目"。当你提出一个开发需求时,除了代码,还按全生命周期编排产出整套研发项目文档:

阶段 文档 落地 skill
立项 立项报告 / 立项申请书、可行性研究报告(可选) devflow-report-writing
需求 需求文档(PRD) devflow-prd
计划 项目计划书 / 任务书 devflow-report-writing
研发实现 研发报告 / 开发报告 devflow-architecture · devflow-report-writing
测试 测试报告(指标驱动) devflow-testing · devflow-report-writing
试运行 试运行报告 devflow-report-writing
验收 / 结题 验收报告、结题 / 结项报告 devflow-report-writing
交付使用 用户操作手册、部署运维手册(可选) devflow-docs · devflow-deployment

考核指标形成"立项定标 → 测试验证 → 验收对标 → 结题闭环"的完整链条。收尾时用 devflow-rd-project 的完整性自检表逐份核对,缺一份都不算交付完成。所有文档统一走 docx skill 落地,未知信息用 XXX 占位,绝不臆造。

设计说明:方法论 vs 项目事实

这套 skill 刻意不含任何固定框架版本、项目路径、具体数据库 schema 或业务模型——那些属于"项目事实",应该写进你自己项目的《项目事实文件》。方法论只固化"怎么做、按什么顺序做、守什么纪律"。

因此它可以复用到任意软件项目:加载 skill → 先做需求对话 → 把对话结论和项目技术事实写进你的 AGENTS.md / DEVELOPMENT_GUIDE.md → 按管线逐阶段推进。

License

Apache License 2.0

About

devflow · A tech-stack-agnostic, end-to-end software delivery methodology packaged as 15 loadable AI agent skills (requirements → PRD → architecture → frontend/backend → database → testing → deployment → docs). Apache-2.0.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors