Claude Code

Appearance

企业级工作流指南 ​

Claude Code 代理 ↔ 模板 ↔ 检查清单 完整工作流生态系统指南。

核心理念 ​

企业级软件开发需要标准化流程、质量保证和智能协作。Claude Code通过三大核心系统的无缝集成，提供从需求到交付的端到端解决方案：

  • ** AI代理系统** - 专业角色和智能协作
  • ** 模板系统** - 标准化文档和流程
  • ** 检查清单系统** - 质量控制和验证

完整生态系统架构 ​

标准工作流程 ​

绿地项目工作流 (新项目开发) ​

阶段1: 项目发现和规划 ​

 用户想法
    ↓
 商业分析师 +  brainstorming-output-tmpl.yaml
    ↓ 生成头脑风暴结果
 project-brief-tmpl.yaml +  产品经理
    ↓ 创建项目简介
 market-research-tmpl.yaml (可选)
    ↓ 市场研究
 competitor-analysis-tmpl.yaml (可选)
    ↓ 竞品分析
 项目发现阶段验证

阶段2: 需求定义和设计 ​

 prd-tmpl.yaml +  产品经理
    ↓ 产品需求文档
 front-end-spec-tmpl.yaml +  UX专家 (UI项目)
    ↓ 前端规格说明
 pm-checklist.md 验证PRD质量
    ↓
 architecture-tmpl.yaml +  架构师
 front-end-architecture-tmpl.yaml (前端项目)
 fullstack-architecture-tmpl.yaml (全栈项目)
    ↓ 架构设计文档
 architect-checklist.md 验证架构质量

阶段3: 开发实施 ​

 story-tmpl.yaml +  产品负责人
    ↓ 用户故事创建
 story-draft-checklist.md 验证故事质量
    ↓
 开发者 + 架构文档
    ↓ 代码实现
 story-dod-checklist.md 验证完成标准
    ↓
 QA + 测试策略
    ↓ 质量保证
 最终交付验证

棕地项目工作流 (现有项目增强) ​

阶段1: 现有系统分析 ​

 增强需求
    ↓
 分析师 + 现有项目代码
    ↓ 系统现状分析
 brownfield-prd-tmpl.yaml +  产品经理
    ↓ 增强需求文档
 pm-checklist.md 验证需求完整性

阶段2: 集成架构设计 ​

 brownfield-architecture-tmpl.yaml +  架构师
    ↓ 集成架构文档
 architect-checklist.md 验证集成方案
    ↓ 兼容性检查
 change-checklist.md 验证变更影响

阶段3: 渐进式开发 ​

 story-tmpl.yaml +  产品负责人
    ↓ 增强故事 (含集成验证)
 开发者 + 现有代码库
    ↓ 功能增强实现
 兼容性测试和验证
    ↓
 QA + 回归测试
    ↓ 质量保证
 生产环境部署验证

团队配置与工作流映射 ​

完整团队 (team-all.yaml) ​

适用场景: 企业级复杂项目
代理组合: 全部核心代理 + 编排器
推荐工作流:

  • 绿地项目: 完整的发现→规划→设计→实施流程
  • 棕地项目: 深度分析→集成设计→渐进实施流程
  • 模板使用: 所有模板类型，根据需要选择
  • 质量保证: 全面的检查清单验证

全栈团队 (team-fullstack.yaml) ​

适用场景: 现代Web应用和SaaS产品
代理组合: 分析师 + PM + UX专家 + 架构师 + PO
推荐工作流:

  • 项目简介 → PRD → 前端规格 → 全栈架构 → 用户故事
  • 重点模板: prd-tmpl.yaml + front-end-spec-tmpl.yaml + fullstack-architecture-tmpl.yaml
  • 检查清单: PM检查清单 + 架构师检查清单 + 故事检查清单

最小团队 (team-ide-minimal.yaml) ​

适用场景: 快速原型和小型项目
代理组合: PO + SM + 开发者 + QA
推荐工作流:

  • 简化流程: 用户故事 → 快速开发 → 质量验证
  • 重点模板: story-tmpl.yaml
  • 检查清单: 故事草稿检查清单 + 完成定义检查清单

后端团队 (team-no-ui.yaml) ​

适用场景: API服务和数据处理系统
代理组合: 分析师 + PM + 架构师 + PO
推荐工作流:

  • PRD (后端导向) → 架构设计 → API规格 → 服务实现
  • 重点模板: prd-tmpl.yaml + architecture-tmpl.yaml
  • 检查清单: PM检查清单 + 架构师检查清单

模板与代理的智能协作 ​

产品规划阶段 ​

模板负责代理协作代理输出文档后续检查清单
brainstorming-output-tmpl.yaml商业分析师产品经理头脑风暴结果-
project-brief-tmpl.yaml产品经理商业分析师项目简介-
market-research-tmpl.yaml商业分析师产品经理市场研究报告-
competitor-analysis-tmpl.yaml商业分析师产品经理竞品分析报告-

需求和设计阶段 ​

模板负责代理协作代理输出文档后续检查清单
prd-tmpl.yaml产品经理UX专家, 架构师产品需求文档pm-checklist.md
brownfield-prd-tmpl.yaml产品经理架构师, 分析师棕地增强PRDpm-checklist.md
front-end-spec-tmpl.yamlUX专家产品经理前端规格说明-

架构设计阶段 ​

模板负责代理协作代理输出文档后续检查清单
architecture-tmpl.yaml架构师产品经理, 开发者架构文档architect-checklist.md
brownfield-architecture-tmpl.yaml架构师产品经理, 分析师棕地架构文档architect-checklist.md
front-end-architecture-tmpl.yaml架构师UX专家, 前端开发者前端架构文档architect-checklist.md
fullstack-architecture-tmpl.yaml架构师产品经理, UX专家全栈架构文档architect-checklist.md

实施管理阶段 ​

模板负责代理协作代理输出文档后续检查清单
story-tmpl.yaml产品负责人Scrum Master, 开发者用户故事story-draft-checklist.md, story-dod-checklist.md

质量控制机制 ​

多层级质量检查体系 ​

1. 文档级检查 (模板内置) ​

  • 即时验证: 模板生成过程中的完整性检查
  • 格式标准: 统一的Markdown格式和结构要求
  • 内容验证: 必填字段和逻辑一致性检查

2. 角色级检查 (检查清单) ​

  • PM检查清单: 验证PRD的商业逻辑和需求完整性
  • 架构师检查清单: 验证技术方案的可行性和一致性
  • 故事检查清单: 验证用户故事的可实施性和验收标准

3. 变更级检查 (影响评估) ​

  • 变更检查清单: 评估需求变更对系统的影响
  • 兼容性检查: 确保棕地项目的向后兼容性
  • 风险评估: 识别和缓解潜在风险

4. 交付级检查 (最终验证) ​

  • 完成定义检查清单: 验证开发任务的完成标准
  • 质量保证检查: 全面的功能和非功能测试
  • 生产就绪检查: 部署前的最终验证

质量反馈循环 ​

 模板生成文档 
    ↓
 检查清单验证
    ↓
 发现问题 →  代理协作解决 →  文档更新
    ↓
 验证通过 →  流程改进 →  模板优化

使用场景和最佳实践 ​

场景1: 创业公司MVP开发 ​

团队选择: team-ide-minimal.yaml
工作流程:

  1. 快速头脑风暴 (brainstorming-output-tmpl.yaml)
  2. 简化PRD (prd-tmpl.yaml 重点功能)
  3. 基础架构 (architecture-tmpl.yaml)
  4. 用户故事快速迭代 (story-tmpl.yaml)

关键实践:

  • 重点关注MVP功能范围
  • 快速原型和用户验证
  • 敏捷迭代和持续改进

场景2: 企业级SaaS产品 ​

团队选择: team-fullstack.yaml
工作流程:

  1. 市场研究和竞品分析
  2. 完整PRD和前端规格
  3. 全栈架构设计
  4. 分阶段实施计划

关键实践:

  • 全面的市场和用户研究
  • 详细的架构设计和技术规划
  • 严格的质量控制和测试
  • 分阶段发布和持续优化

场景3: 现有系统功能增强 ​

团队选择: team-fullstack.yaml 或 team-all.yaml
工作流程:

  1. 现有系统深度分析
  2. 棕地PRD和架构设计
  3. 渐进式集成开发
  4. 兼容性测试和部署

关键实践:

  • 充分理解现有系统架构
  • 注重向后兼容性
  • 渐进式功能发布
  • 全面的回归测试

场景4: 微服务API开发 ​

团队选择: team-no-ui.yaml
工作流程:

  1. API需求分析和设计
  2. 服务架构规划
  3. API规格定义
  4. 服务实现和测试

关键实践:

  • API优先设计
  • 服务边界清晰定义
  • 完善的API文档
  • 自动化测试和监控

自定义和扩展 ​

自定义团队配置 ​

yaml
bundle:
  name: "定制团队"
  icon: ""
  description: "针对特定项目需求的定制团队"
agents:
  - pm
  - architect
  - custom-specialist
workflows:
  - custom-workflow.yaml

自定义模板 ​

yaml
template:
  id: custom-template-v1
  name: "定制模板"
  version: 1.0
  output:
    format: markdown
    filename: docs/custom-output.md
    title: "{{project_name}} 定制文档"

workflow:
  mode: interactive
  elicitation: advanced-elicitation

sections:
  - id: custom-section
    title: "定制章节"
    instruction: "根据特定需求定制的章节内容"

自定义检查清单 ​

yaml
checklist:
  name: "定制检查清单"
  version: 1.0
  
items:
  - category: "业务验证"
    checks:
      - item: "业务目标明确定义"
        required: true
      - item: "成功指标可测量"
        required: true

持续改进和优化 ​

度量和分析 ​

  • 效率指标: 文档生成时间、错误率、返工次数
  • 质量指标: 检查清单通过率、缺陷发现率、用户满意度
  • 协作指标: 代理协作效率、跨角色沟通质量

反馈和优化 ​

  • 用户反馈: 收集使用体验和改进建议
  • 模板优化: 基于使用数据优化模板结构
  • 流程改进: 根据项目结果调整工作流程

最佳实践分享 ​

  • 成功案例: 记录和分享成功的项目实践
  • 模式库: 建立可复用的最佳实践模式
  • 知识管理: 将经验转化为可执行的指导

企业级工作流指南 - 智能协作的完整解决方案

Claude Code 使用指南

Copyright © 2025