AI导哈

AI开发工作流

一个面向AI代理团队的生产级应用开发的综合性、分阶段工作流系统，提供多代理协调、分阶段开发、强制性质量体系和会话连续性等功能。

  • by jbcrane13
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jbcrane13/claude-dev-workflow

使用说明

Claude开发工作流程

版本: 3.2.0 最后更新: 2025-01-31 许可证：MIT

🎯 概述

为构建生产质量应用程序的AI代理团队提供全面的、基于阶段的开发工作流程。该系统提供：

  • 多智能体协调 -协调监督的并行执行
  • 基于阶段的开发 -工作特性的增量交付
  • 强制性质量体系 -相位门、ADR、系统验证
  • 会话连续性 -跨会话无缝切换
  • Zen MCP集成 -通过人工智能工具增强协作
  • 生产就绪 -久经考验的模式和实践

🚀 从这里开始：阅读 claude.md 对于完整的工作流程

📚 文档

主要入口点

📖 claude.md - 从这里开始 -具有强制性要求的完整工作流程

核心工作流程文档

文件 目的
代理部署 多智能体团队结构（带决策树）
iOS 开发 iOS技术标准（含强制性规则）
项目管理 基于阶段的规划
会话管理 上下文保存
质量门 完成标准
测试指南 测试要求
禅工具指南 MCP工具使用
工具链模式 经过验证的工具序列
模拟数据策略 数据转换规划

模板和跟踪

文件 目的
PRD模板 产品要求文件
ADR模板 架构决策记录
技术债务日志 债务跟踪模板
性能基线 性能监控

🚀 快速开始

适用于iOS项目

# 1. Clone this repository
git clone https://github.com/yourusername/claude-dev-workflow.git
cd claude-dev-workflow

# 2. Deploy iOS project
./scripts/deploy-ios-project.sh "MyApp" "/path/to/projects"

# 3. Read the workflow documentation
cat claude.md  # Start here - includes MANDATORY requirements

# 4. Review iOS standards
cat docs/ios-development.md  # iOS mandatory rules at top

对于其他项目类型

马上就来：

  • 安卓部署脚本（v3.2）
  • Web应用程序部署脚本（v3.3）
  • 通用软件部署脚本（v3.4）

📁 存储库结构

claude-dev-workflow/
├── README.md                          # This file - quick overview
├── claude.md                          # ⚠️ START HERE - complete workflow
├── QUICK_REFERENCE.md                 # One-page quick reference
│
├── docs/                              # Complete documentation (9 guides)
│   ├── agent-deployment.md            # Team structures + decision tree
│   ├── ios-development.md             # iOS standards + mandatory rules
│   ├── project-management.md          # Phase planning
│   ├── session-management.md          # Context preservation
│   ├── quality-gates.md               # Completion criteria
│   ├── testing-guidelines.md          # Testing requirements
│   ├── zen-tools-guide.md             # MCP tool usage
│   ├── tool-chaining-patterns.md      # Tool sequences
│   ├── mock-data-strategy.md          # Data strategy
│   ├── PRD.md                         # PRD template
│   └── adr/                           # Architecture Decision Records
│       ├── README.md                  # ADR guide
│       └── template.md                # ADR template
│
├── templates/                         # Project templates
│   └── ios/                           # iOS project template
│
├── tracking/                          # Tracking templates
│   ├── session-state.md               # Session state
│   ├── phase-status.md                # Phase progress
│   ├── mock-data-registry.md          # Mock data tracking
│   ├── technical-debt-log.md          # Debt monitoring
│   ├── performance-baseline.md        # Performance tracking
│   └── knowledge-base/                # Knowledge preservation
│
├── scripts/                           # Deployment scripts
│   └── deploy-ios-project.sh          # iOS project setup
│
└── examples/                          # Example projects (coming)

🎭 支持的项目类型

✅ 完全支持

iOS应用程序 （swift、swiftui、swiftdata）

  • 完整的部署脚本
  • 强制性技术标准
  • 示例项目（即将推出）
  • 5人团队结构

macOS应用程序 （swift、swiftui、swiftdata）

  • 强制性技术标准
  • 与iOS相同的5人团队结构
  • 部署脚本（即将发布）

🚧 即将推出

  • Android应用程序 （Kotlin，Jetpack Compose）-v3.2
  • Web应用程序 （React、Vue、Next.js）-v3.3
  • 后端服务 （Node.js、Python、Go）-v3.4

🤖 多代理团队

iOS/macOS开发团队（5名代理）

Coordinator Agent
└── Manages workflow, ensures quality gates

Architecture Agent
└── SwiftUI/SwiftData design

Feature Agents (2x)
└── Parallel implementation

Testing Agent
└── Quality verification

备注iOS和macOS使用相同的团队结构

何时部署团队：请参阅中的决策树 代理部署.md

Web应用程序团队（6个代理）

Coordinator + Backend + Frontend + UI + Database + Testing

看: 代理部署指南 对于完整的结构

✅ 强制性要求

在开始任何工作之前，您必须：

  1. 部署多代理团队 （适用于具有3+功能的项目）
  2. 遵循平台标准 （iOS/macOS：SwiftUI、SwiftData、@Observable）
  3. 通过质量门 （zen预提交、截图、测试、构建）
  4. 运行阶段闸门 （分析+重构+在每个阶段结束时分析）

看: claude.md-强制性要求部分 有关完整详细信息

📋 开发工作流程

Phase 0: Foundation & Planning
   ↓
   Deploy Multi-Agent Team
   ↓
Phase 1: Core P1 Features (MVP)
   ↓
   🚦 MANDATORY PHASE GATE
   ↓
Phase 2: Enhanced Features
   ↓
   🚦 MANDATORY PHASE GATE
   ↓
Phase N: Production Ready

各级质量门：

  • 任务：预提交、截图、测试、构建
  • 阶段：分析、重构、分析（性能）

📸 截图证据

关键要求：没有截图证明，什么都不完整！

tracking/screenshots/
├── phase1-feature-name.png
├── phase2-feature-name.png
└── phase3-feature-name.png

🔧 Zen MCP工具

工具 目的 需要时
planner 项目分解 第0阶段，规划
analyze 代码库分析 相位门（必填）
refactor 代码改进 相位门（必填）
codereview 质量验证 完工前
debug 问题解决 出现问题时
precommit 最终验证 每次提交前（必填）
consensus 团队一致性 重大决策（ADR）

看: 禅工具指南 完全使用

🎯 入门检查表

新项目设置：

  • []克隆此存储库
  • [ ] 阅读 claude.md 完全 （包括强制性要求）
  • []审查 代理部署.md 决策树
  • []对于iOS：阅读 ios-development.md 强制性规则
  • []对于macOS：阅读 mac-development.md 强制性规则
  • []为您的平台运行部署脚本
  • []部署多代理团队（如适用）
  • []使用创建PRD PRD模板
  • []使用禅 planner 与PRD共同制定项目计划
  • []开始阶段0：基础

💡 最佳实践

规划

  • 使用禅 planner 用于故障
  • 提前定义阶段
  • 尽早识别P1特征

执行

  • 为3个以上的功能项目部署团队
  • 一次专注于一个阶段
  • 永远不要跳过质量门
  • 切勿跳过相位门

质量

  • 润禅 precommit 每次提交之前
  • 为每个功能捕获屏幕截图
  • 连续测试（≥70%覆盖率）
  • 经常构建

📦 安装

# Clone repository
git clone https://github.com/yourusername/claude-dev-workflow.git
cd claude-dev-workflow

# Deploy iOS project
chmod +x scripts/deploy-ios-project.sh
./scripts/deploy-ios-project.sh "MyApp" "~/Projects"

# Start development
cd ~/Projects/MyApp
cat claude.md  # Read workflow

🤝 贡献

我们欢迎捐款！看 贡献.md 作为指导方针。

高优先级：

  • Android部署脚本
  • Web部署脚本
  • 示例项目
  • 文档改进

📊 版本历史记录

当前版本：v3.2.0（2025年1月31日）

最新变化:

  • ✅ macOS开发支持 -macOS应用程序的完整指南
  • ✅ 与iOS相同的强制性技术栈（SwiftUI、SwiftData、@Observable）
  • ✅ 平台无关的团队结构适用于iOS和macOS

看: 更改日志.md 获取完整的版本历史记录

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🆘 支持

文档

常见问题

构建失败 → 使用禅 debug，审查质量门 代理商协调 → 查看代理部署.md决策树 上下文丢失 → 检查会话管理.md

⭐ 关键要点

  1. 📖 阅读 claude.md 第一 -顶部的强制性要求
  2. 🤖 为3个以上的功能项目部署团队 -使用决策树
  3. 📱 iOS/macOS：遵循强制性技术栈 -SwiftUI，SwiftData，@仅可观察
  4. ✅ 通过所有质量门 -每次提交前先提交
  5. 🚦 运行阶段闸门 -在每个阶段结束时进行分析+重构+分析
  6. 📸 截图一切 -没有证据，什么都不完整

内置❤️ 面向人工智能驱动的开发团队

准备好开始了吗？ → 阅读claude.md

相关 MCP