# dev-sync-agent **Repository Path**: wds-sync/dev-sync-agent ## Basic Information - **Project Name**: dev-sync-agent - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-12-21 - **Last Updated**: 2025-12-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DevSyncAgent **面向大数据团队的AI驱动全流程研发协作Agent** --- ## 📖 项目简介 DevSyncAgent是一个基于Claude Code构建的AI Agent体系，覆盖软件研发全流程（需求→设计→开发→测试→运维），专为大数据团队优化。 ### 核心特性 🎯 **需求类型驱动**：自动识别需求类型（明确/模糊/探索），匹配对应工作流 🔄 **阶段化流程**：清晰的5阶段流程，每个阶段有明确的输入、输出和质量门禁 🧩 **高度可扩展**：配置驱动架构，插件化技术栈，模板化标准 📚 **知识沉淀**：Dev Docs持久化模式，跨会话保持上下文 🔧 **大数据优化**：针对大数据项目特点优化（数据依赖、性能评估、技术选型） --- ## 🚀 快速开始 ### 前置条件 - Claude Code已安装 - Node.js ≥ 18 (用于Hooks) - Git Bash / WSL (Windows用户) ### 安装步骤 ```bash # 1. Clone项目 git clone cd DevSyncAgent # 2. 安装Hooks依赖 cd .claude/hooks npm install npm run build # 3. 配置Claude Code # 将.claude/settings.json合并到您的Claude Code配置中 ``` ### 第一个需求 ```bash # 使用 /dev-flow 命令启动完整开发工作流： /dev-flow 新增一个销售数据报表 # DevSyncAgent会自动： # 1. 检测输入格式（模板/非模板） # 2. 识别需求类型（NEW/ENHANCE/FIX/OPTIMIZE/REFACTOR/INTEGRATE） # 3. 创建任务工作区（dev/active/[task-name]/） # 4. 询问执行模式（快速模式/分步模式） # 5. 依次执行5个阶段（澄清→需求分析→设计→开发→测试） ``` **支持的6种需求类型**： | 类型 | 说明 | 示例 | |-----|------|------| | **NEW** | 全新功能模块 | `/dev-flow 新增用户权限管理模块` | | **ENHANCE** | 扩展现有功能 | `/dev-flow 为订单模块添加导出Excel功能` | | **FIX** | Bug修复 | `/dev-flow 修复登录接口返回500错误` | | **OPTIMIZE** | 性能/运维/代码优化 | `/dev-flow 优化用户列表查询性能` | | **REFACTOR** | 架构级重构 | `/dev-flow 重构用户模块，解决循环依赖` | | **INTEGRATE** | 第三方系统集成 | `/dev-flow 集成钉钉消息通知` | --- ## 🏗️ 项目结构 ``` DevSyncAgent/ ├── .claude/ │ ├── config/ # 配置中心（核心） │ │ ├── req-type-rules.json │ │ ├── stage-flow-rules.json │ │ ├── template-extraction-rules.json │ │ └── tech-stack.json │ │ │ ├── agents/ # Agent库（核心） │ │ ├── requirement/ # 需求分析Agents │ │ │ ├── req-type-classifier.md # 开发流程主控 (v3.4) │ │ │ ├── req-clarification-orchestrator.md │ │ │ ├── req-new-feature-analyzer.md │ │ │ └── ... │ │ ├── design/ # 设计生成Agents │ │ ├── development/ # 代码开发Agents │ │ ├── testing/ # 测试生成Agents │ │ └── analysis/ # 项目分析Agents │ │ │ ├── commands/ # 斜杠命令 │ │ └── dev-flow.md # /dev-flow 命令 │ │ │ ├── skills/ # 技能库（部分已弃用） │ ├── templates/ # 模板库 │ └── standards/ # 规范库 │ ├── dev/active/ # 任务工作区 │ └── [task-name]/ │ ├── context.md # 任务上下文和进度 │ └── clarification_result.json │ └── docs/ # 文档输出 └── {branch}/ ├── requirements/ # 需求文档 ├── features/ # Feature文件 ├── design/ # 设计文档 └── testing/ # 测试用例 ``` --- ## 🎯 核心概念 ### 开发工作流架构 ``` /dev-flow 命令 ↓ req-type-classifier（开发流程主控 v3.4） ↓ ┌───────────────────────────────────────────────┐ │ 5阶段开发流程 │ ├───────────────────────────────────────────────┤ │ 阶段0: 需求澄清 (req-clarification-orchestrator) │ │ ↓ │ │ 阶段1: 需求分析 (req-xxx-analyzer) │ │ ↓ │ │ 阶段2: 设计方案 (des-xxx) │ │ ↓ │ │ 阶段3: 代码开发 (java/python-code-developer) │ │ ↓ │ │ 阶段4: 测试生成 (functional-test-generator) │ └───────────────────────────────────────────────┘ ``` ### 执行模式 | 模式 | 说明 | 适用场景 | |-----|------|---------| | **快速模式** | 自动依次执行5个阶段 | 需求明确、信任度高 | | **分步模式** | 每阶段完成后暂停等待确认 | 复杂需求、需要精细控制 | ### 任务管理 - **任务工作区**：`dev/active/[task-name]/` - **状态持久化**：`context.md`记录进度，支持中断恢复 - **恢复任务**：`/dev-flow resume [task-name]` - **查看状态**：`/dev-flow status` --- ## 📚 使用指南 ### 工作流示例：新增功能需求 #### 1. 启动工作流 ```bash /dev-flow 新增一个销售趋势分析报表 ``` #### 2. 需求类型识别 ``` 🎯 需求类型识别结果 **需求类型**：新增功能（NEW） **置信度**：92% **优先级**：P1 ## 判断依据 - ✓ 包含关键词"新增" - ✓ 描述了明确的业务功能（销售趋势分析） - ✓ 项目中不存在类似模块 ``` #### 3. 选择执行模式 ``` ⚙️ 执行模式选择 请选择： 1. 快速模式（自动执行，每阶段完成后按回车继续） 2. 分步模式（每阶段完成后等待确认） ``` #### 4. 5阶段流程执行 | 阶段 | Agent | 输出物 | |-----|-------|-------| | 阶段0 | req-clarification-orchestrator | clarification_result.json | | 阶段1 | req-new-feature-analyzer | 需求文档 + Feature文件 | | 阶段2 | des-new-feature | 设计文档 | | 阶段3 | java/python-code-developer | 源代码 + 单元测试 | | 阶段4 | functional-test-generator | 测试用例文档 | #### 5. 中断和恢复 ```bash # 执行过程中可随时暂停 输入：暂停 # 下次继续时恢复 /dev-flow resume sales-trend-report ``` --- ## 🔧 配置说明 ### 自定义需求类型规则 编辑 `.claude/config/req-type-rules.json`： ```json { "requirementTypes": { "your-custom-type": { "displayName": "自定义类型", "workflow": "custom-workflow", "detectionRules": { "keywords": ["关键词1", "关键词2"], "patterns": ["正则模式1"] } } } } ``` ### 添加新阶段 编辑 `.claude/config/stage-flow-rules.json`，在workflows中添加新的stage配置。 ### 扩展技术栈 1. 在 `.claude/skills/tech-stacks/` 下创建新技能目录 2. 编写SKILL.md和resources 3. 在 `.claude/config/tech-stack.json` 中启用 --- ## 🎓 最佳实践 ### ✅ 推荐做法 1. **遵循阶段流程**：不要跳过质量门禁 2. **使用模板**：确保一致性和完整性 3. **记录决策**：在Dev Docs中记录所有重要决策 4. **定期同步**：更新context.md保持上下文最新 ### ❌ 避免做法 1. 在需求阶段讨论实现细节 2. 跳过风险识别环节 3. 接受模糊的验收标准 4. 忽略数据依赖（大数据项目） --- ## 🗺️ Roadmap ### v2.x 已完成 ✅ - [x] 6类需求分类（NEW/ENHANCE/FIX/OPTIMIZE/REFACTOR/INTEGRATE） - [x] 5阶段开发流程（澄清→需求→设计→开发→测试） - [x] 需求澄清多轮对话机制（1-8轮，三种方法论） - [x] 需求拆分智能化（双策略机制） - [x] Gherkin Feature文件支持 - [x] 项目上下文全面感知 - [x] 需求描述模板化智能适配 - [x] 需求澄清深度优化（动态轮次、完成度评估） - [x] **v2.13: dev-flow直接调用req-type-classifier架构优化** ### v3.x 计划中 - [ ] 前端技术栈支持（Vue/React） - [ ] 多人协作支持 - [ ] 案例库和知识沉淀 - [ ] 指标Dashboard --- ## 🤝 贡献 欢迎贡献！请遵循以下原则： 1. **技能文件<500行**：遵循渐进式披露原则 2. **配置驱动**：避免硬编码 3. **文档完善**：每个新功能都需要文档 4. **测试验证**：确保功能正常工作 --- ## 📄 许可 MIT License --- ## 🙏 致谢 本项目深度借鉴了 [claude-code-infrastructure-showcase](https://github.com/anthropics/claude-code-infrastructure-showcase) 的设计理念： - 配置驱动的技能激活机制 - 渐进式披露（500行规则） - Dev Docs持久化模式 - Hook自动化架构 --- ## 📞 联系方式 - Issues: [GitHub Issues](项目地址/issues) - 文档: [完整文档](./docs/) --- **Built with ❤️ for Data Teams** *Version: 2.13.0* *Last Updated: 2025-12-05*