Claude开发工作流程
版本: 3.2.0 最后更新: 2025-01-31 许可证:MIT
______________________________________________________________________
🎯 概述
为构建生产质量应用程序的AI代理团队提供全面的、基于阶段的开发工作流程。该系统提供:
- 多智能体协调 -协调监督的并行执行
- 基于阶段的开发 -工作特性的增量交付
- 强制性质量体系 -相位门、ADR、系统验证
- 会话连续性 -跨会话无缝切换
- Zen MCP集成 -通过人工智能工具增强协作
- 生产就绪 -久经考验的模式和实践
🚀 从这里开始:阅读 claude.md 对于完整的工作流程
______________________________________________________________________
📚 文档
主要入口点
📖 claude.md - 从这里开始 -具有强制性要求的完整工作流程
核心工作流程文档
| 文件 | 目的 |
|---|---|
| 代理部署 | 多智能体团队结构(带决策树) |
| iOS 开发 | iOS技术标准(含强制性规则) |
| 项目管理 | 基于阶段的规划 |
| 会话管理 | 上下文保存 |
| 质量门 | 完成标准 |
| 测试指南 | 测试要求 |
| 禅工具指南 | MCP工具使用 |
| 工具链模式 | 经过验证的工具序列 |
| 模拟数据策略 | 数据转换规划 |
模板和跟踪
______________________________________________________________________
🚀 快速开始
适用于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看: 代理部署指南 对于完整的结构
______________________________________________________________________
✅ 强制性要求
在开始任何工作之前,您必须:
- 部署多代理团队 (适用于具有3+功能的项目)
- 遵循平台标准 (iOS/macOS:SwiftUI、SwiftData、@Observable)
- 通过质量门 (zen预提交、截图、测试、构建)
- 运行阶段闸门 (分析+重构+在每个阶段结束时分析)
看: 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
______________________________________________________________________
⭐ 关键要点
- 📖 阅读 claude.md 第一 -顶部的强制性要求
- 🤖 为3个以上的功能项目部署团队 -使用决策树
- 📱 iOS/macOS:遵循强制性技术栈 -SwiftUI,SwiftData,@仅可观察
- ✅ 通过所有质量门 -每次提交前先提交
- 🚦 运行阶段闸门 -在每个阶段结束时进行分析+重构+分析
- 📸 截图一切 -没有证据,什么都不完整
______________________________________________________________________
内置❤️ 面向人工智能驱动的开发团队
准备好开始了吗? → 阅读claude.md
