cilangzzz/software-dev-ai-workflow

---

这是什么

一套 AI 驱动的软件开发全流程框架。它不是代码库，而是一个结构化的知识体系——定义了 AI Agent 在软件开发各角色中"该怎么干、干什么、产出什么"，帮助团队建立标准化的研发流程和文档规范。

框架特性：

• 🔄 双流程支持 — 瀑布 / 敏捷全流程定义，含质量门控检查点（Gate 1-5）
• 🏭 行业系统模型 — 内置 ERP（12 模块）、MES（10+ 模块）、语音社区等完整参考架构
• 🔧 27+ 通用技能 — SSH、Word、Draw.io、Notion、Jira、禅道等工具集成
• 🤖 8 阶段端到端工作流 — .claude/ 下预置从需求分析到前后端开发的可执行编排
• 🧬 可自扩展 — 通过 author-agent / author-skill 元技能，AI 自行创建新角色和新技能
• 📐 质量门控 — 每阶段有可量化检查标准，不达标不放行
• 🗂️ 单一事实源 — 自动生成 catalog.json、Skill 总目录、按阶段产出物、按部门产出物

---

适用人群

覆盖 8 大角色 Agent：产品、研发、测试、运维、安全、设计、数据、项目管理

---

能做什么

📋 产品阶段

🏗️ 设计阶段

💻 开发阶段

🧪 测试阶段

🚀 运维阶段

---

目录结构

software-dev-ai-workflow/
├── .claude/                           # Claude Code 编排入口（推荐从此入手）
│   ├── skills/                        # 8 阶段 Skill（stage-01 ~ stage-08）
│   └── workflows/                     # 8 阶段工作流脚本
├── catalog.json                       # 仓库级 Skill 单一事实源（自动生成）
├── docs/                              # 自动生成文档
│   ├── skill-index.md                 # Skill 总目录（按阶段/部门/通用四象限）
│   └── deliverables/                  # 产出物单一事实源
│       ├── by-stage.md                # 按阶段汇总
│       └── by-department.md           # 按部门汇总
├── 0.0-通用skill/                    # 通用技能工具集（27 个子目录）
│   ├── author-build-project-docs/    # 项目文档生成
│   └── manage-项目管理/              # 项目管理工具
├── 1.0-软件开发流程角色agent模型/      # 角色Agent定义
├── 2.0-用例/                         # 用例示例库 ⭐
│   ├── agent用例/                    # Agent使用示例
│   ├── 工作流/                       # 端到端工作流示例
│   ├── 开发流程样例/                  # 瀑布/敏捷流程
│   ├── 系统模型样例/                  # ERP、MES、VCP
│   └── 项目管理样例/                  # 项目管理模板
├── 3.0-基础开发系统模板/              # 基础开发框架（git submodule）
├── _deprecated/                      # 归档的旧版 Skill（仅供溯源）
└── output/                           # 输出目录

---

快速开始

使用步骤

1. 选择角色Agent → 从 1.0-软件开发流程角色agent模型/ 选择
2. 查看用例示例 → 进入 2.0-用例/ 查看详细示例
3. 输入需求描述 → 告诉AI你想做什么
4. 获取产出 → AI自动生成文档或代码

用例导航

---

示例项目

---

贡献指南

欢迎贡献新的 Agent、Skill 或改进现有内容！

贡献方式

提交流程

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/YourFeature)
3. 提交更改 (git commit -m 'Add: 新增xxx功能')
4. 推送到分支 (git push origin feature/YourFeature)
5. 提交 Pull Request

文档规范

• Agent 定义文件使用 SKILL.md 格式
• 目录命名使用中文，便于理解
• 示例文件包含完整的输入输出说明

许可证

MIT License

---