Claude Code

Appearance

用户使用指南 ​

Claude Code企业级开发助手完整使用指南，帮助不同角色快速上手并充分利用系统能力。

快速开始 ​

30秒快速体验 ​

bash
# 1. 选择团队配置
/load --team fullstack

# 2. 创建产品需求文档
/implement --template prd-tmpl --project "我的项目"

# 3. 开始开发
/implement --story "用户登录功能"

核心概念理解 ​

  • ** AI代理**: 专业角色，如产品经理、架构师、开发者
  • ** 模板系统**: 标准化文档生成工具
  • ** 团队配置**: 预设的代理组合方案
  • ** 检查清单**: 质量控制和验证工具

产品经理使用指南 ​

核心职责 ​

  • 产品需求定义和规划
  • 市场研究和竞品分析
  • 用户故事管理
  • 产品路线图制定

推荐工作流程 ​

1. 新产品规划 ​

bash
# 团队配置
/load --team fullstack

# 市场研究
/implement --template market-research-tmpl --product "我的SaaS产品"

# 竞品分析
/implement --template competitor-analysis-tmpl --competitors "竞争对手列表"

# 项目简介
/implement --template project-brief-tmpl --project "产品名称"

# 产品需求文档
/implement --template prd-tmpl --project "产品名称"

2. 现有产品增强 ​

bash
# 棕地项目分析
/analyze --scope project --focus requirements

# 增强需求文档
/implement --template brownfield-prd-tmpl --enhancement "新功能描述"

# 变更影响评估
/implement --checklist change-checklist

常用模板 ​

  • prd-tmpl.yaml: 标准产品需求文档
  • brownfield-prd-tmpl.yaml: 现有产品增强PRD
  • market-research-tmpl.yaml: 市场研究报告
  • competitor-analysis-tmpl.yaml: 竞品分析报告
  • project-brief-tmpl.yaml: 项目简介文档

质量检查 ​

  • pm-checklist.md: PRD质量验证
  • change-checklist.md: 变更影响评估

最佳实践 ​

  1. 用户导向: 始终以用户价值为核心
  2. 数据驱动: 基于市场数据和用户反馈做决定
  3. 迭代优化: 通过持续反馈改进产品
  4. 跨团队协作: 与设计师、工程师密切合作

架构师使用指南 ​

核心职责 ​

  • 系统架构设计
  • 技术栈选择和决策
  • 性能和安全规划
  • 技术风险评估

推荐工作流程 ​

1. 绿地项目架构 ​

bash
# 团队配置
/load --team fullstack

# 阅读产品需求
/load docs/prd.md

# 系统架构设计
/implement --template architecture-tmpl --project "项目名称"

# 前端架构(如需要)
/implement --template front-end-architecture-tmpl --project "项目名称"

# 全栈架构(现代应用)
/implement --template fullstack-architecture-tmpl --project "项目名称"

2. 棕地项目架构 ​

bash
# 现有系统分析
/analyze --scope project --focus architecture

# 棕地架构设计
/implement --template brownfield-architecture-tmpl --enhancement "功能描述"

# 集成方案验证
/implement --checklist architect-checklist

常用模板 ​

  • architecture-tmpl.yaml: 标准系统架构
  • brownfield-architecture-tmpl.yaml: 棕地项目架构
  • front-end-architecture-tmpl.yaml: 前端专项架构
  • fullstack-architecture-tmpl.yaml: 全栈统一架构

质量检查 ​

  • architect-checklist.md: 架构质量验证
  • change-checklist.md: 技术变更评估

最佳实践 ​

  1. 模块化设计: 高内聚、低耦合的系统设计
  2. 技术选型: 基于业务需求和团队能力选择技术
  3. 性能优先: 从架构层面考虑性能和扩展性
  4. 安全内置: 将安全考虑融入架构设计

UX/UI设计师使用指南 ​

核心职责 ​

  • 用户体验设计
  • 界面原型和规格
  • 设计系统建立
  • 可用性测试

推荐工作流程 ​

1. UI/UX规格设计 ​

bash
# 团队配置
/load --team fullstack

# 阅读产品需求
/load docs/prd.md

# 前端规格设计
/implement --template front-end-spec-tmpl --project "项目名称"

# 前端架构协作
/collaborate --with architect --template front-end-architecture-tmpl

常用模板 ​

  • front-end-spec-tmpl.yaml: UI/UX详细规格
  • front-end-architecture-tmpl.yaml: 前端技术架构

协作建议 ​

  • 与产品经理协作定义用户需求
  • 与架构师协作确定技术实现方案
  • 与开发者协作确保设计可实现性

最佳实践 ​

  1. 用户中心: 以用户体验为设计核心
  2. 一致性: 建立和维护设计系统
  3. 可访问性: 遵循无障碍设计原则
  4. 迭代设计: 基于用户反馈持续改进

开发者使用指南 ​

核心职责 ​

  • 功能开发和实现
  • 代码质量保证
  • 技术债务管理
  • 性能优化

推荐工作流程 ​

1. 功能开发 ​

bash
# 最小团队配置
/load --team ide-minimal

# 阅读用户故事
/load docs/stories/

# 实现功能
/implement --story "用户登录功能"

# 代码质量检查
/improve --focus quality

# 测试验证
/test --type unit
/test --type integration

2. 代码重构 ​

bash
# 代码分析
/analyze --scope file --focus quality

# 重构优化
/improve --target performance
/cleanup --debt technical

# 质量验证
/test --coverage

常用命令 ​

  • /implement: 功能实现
  • /improve: 代码改进
  • /analyze: 代码分析
  • /test: 测试执行
  • /cleanup: 代码清理

质量检查 ​

  • story-dod-checklist.md: 用户故事完成定义

最佳实践 ​

  1. 测试驱动: 先写测试，后写实现
  2. 代码规范: 遵循团队编码标准
  3. 持续集成: 频繁提交和集成代码
  4. 性能意识: 关注代码性能和资源使用

QA工程师使用指南 ​

核心职责 ​

  • 测试策略制定
  • 质量标准执行
  • 缺陷发现和跟踪
  • 自动化测试建设

推荐工作流程 ​

1. 测试执行 ​

bash
# 最小团队配置
/load --team ide-minimal

# 功能测试
/test --type functional --story "用户故事ID"

# 集成测试
/test --type integration --scope module

# 端到端测试
/test --type e2e --workflow "关键用户流程"

# 性能测试
/test --type performance --target response-time

2. 质量验证 ​

bash
# 故事完成验证
/implement --checklist story-dod-checklist

# 质量标准检查
/analyze --focus quality --coverage

# 缺陷报告
/document --type bug-report --severity high

常用命令 ​

  • /test: 各类测试执行
  • /analyze: 质量分析
  • /implement --checklist: 检查清单验证

质量检查 ​

  • story-dod-checklist.md: 故事完成标准
  • 各种专业检查清单: 根据项目需要

最佳实践 ​

  1. 早期介入: 在需求阶段就参与质量规划
  2. 自动化优先: 尽可能自动化重复测试
  3. 风险导向: 基于风险优先级安排测试
  4. 数据驱动: 用测试数据支持质量决策

商业分析师使用指南 ​

核心职责 ​

  • 市场研究和分析
  • 商业模式设计
  • 竞争对手分析
  • 业务流程优化

推荐工作流程 ​

1. 市场分析 ​

bash
# 完整团队配置
/load --team all

# 市场研究
/implement --template market-research-tmpl --market "目标市场"

# 竞品分析
/implement --template competitor-analysis-tmpl --focus "竞争优势"

# 商业模式分析
/analyze --scope business --focus opportunity

2. 业务需求分析 ​

bash
# 头脑风暴组织
/implement --template brainstorming-output-tmpl --topic "业务创新"

# 业务流程分析
/analyze --scope workflow --focus efficiency

# 需求整理和验证
/collaborate --with pm --focus requirements

常用模板 ​

  • market-research-tmpl.yaml: 市场研究报告
  • competitor-analysis-tmpl.yaml: 竞品分析报告
  • brainstorming-output-tmpl.yaml: 头脑风暴结果

最佳实践 ​

  1. 数据驱动: 基于可靠数据进行分析
  2. 系统思维: 考虑业务的整体性和关联性
  3. 用户洞察: 深入理解目标用户需求
  4. 趋势敏感: 关注行业发展趋势和变化

按项目类型的使用指南 ​

初创公司MVP ​

推荐配置: team-ide-minimal.yaml

快速启动流程:

bash
# 1. 快速需求定义
/implement --template project-brief-tmpl --mvp true

# 2. 简化架构
/implement --template architecture-tmpl --scope minimal

# 3. 核心功能开发
/implement --story "MVP核心功能"

# 4. 快速测试验证
/test --type smoke --critical-path

关键原则:

  • 聚焦核心价值
  • 快速验证假设
  • 用户反馈驱动
  • 技术债务可控

企业级应用 ​

推荐配置: team-all.yaml

完整开发流程:

bash
# 1. 全面业务分析
/implement --template market-research-tmpl
/implement --template competitor-analysis-tmpl

# 2. 详细需求规划
/implement --template prd-tmpl --enterprise true

# 3. 企业级架构
/implement --template architecture-tmpl --scale enterprise

# 4. 分阶段实施
/implement --template story-tmpl --epic "第一阶段功能"

关键原则:

  • 全面的前期规划
  • 严格的质量控制
  • 分阶段交付
  • 长期维护考虑

微服务项目 ​

推荐配置: team-no-ui.yaml

专业服务开发:

bash
# 1. API需求分析
/implement --template prd-tmpl --focus api

# 2. 服务架构设计
/implement --template architecture-tmpl --type microservice

# 3. API规格定义
/design --type api-spec --standard openapi

# 4. 服务实现和测试
/implement --service "用户认证服务"
/test --type api --coverage 90%

关键原则:

  • API优先设计
  • 服务独立部署
  • 完善的监控
  • 容错和恢复

移动应用 ​

推荐配置: team-fullstack.yaml

移动优先开发:

bash
# 1. 移动UX设计
/implement --template front-end-spec-tmpl --platform mobile

# 2. 移动架构设计
/implement --template fullstack-architecture-tmpl --target mobile

# 3. 响应式开发
/implement --responsive --breakpoints mobile-first

# 4. 移动端测试
/test --type mobile --devices "iOS,Android"

关键原则:

  • 移动优先设计
  • 性能优化重要
  • 离线功能考虑
  • 多平台兼容

高级使用技巧 ​

1. 命令组合和批处理 ​

bash
# 批量文档生成
/implement --template prd-tmpl --project "项目A" && \
/implement --template architecture-tmpl --project "项目A" && \
/implement --checklist pm-checklist

# 并行任务执行
/spawn --parallel --tasks "前端开发,后端开发,测试准备"

2. 自定义工作流 ​

bash
# 创建自定义工作流
/workflow create --name "定制流程" --steps "需求,设计,开发,测试"

# 执行自定义工作流
/workflow run --name "定制流程" --project "我的项目"

3. 质量门禁自动化 ​

bash
# 设置自动质量检查
/configure --quality-gates auto --checklists "pm,architect,story"

# 持续集成集成
/integrate --ci-cd --platform github-actions --quality-checks enabled

4. 团队协作优化 ​

bash
# 团队状态同步
/team sync --status --blockers

# 协作会议准备
/prepare --meeting standup --agenda auto

# 知识共享
/document --type knowledge-base --auto-update

故障排除和FAQ ​

常见问题 ​

Q1: 模板生成失败怎么办？ ​

bash
# 检查模板状态
/template status --name prd-tmpl

# 重新生成
/template regenerate --name prd-tmpl --force

# 查看详细错误日志
/debug --template prd-tmpl --verbose

Q2: 代理协作出现冲突？ ​

bash
# 检查团队配置
/team info --config current

# 重新配置团队
/team configure --resolve-conflicts

# 手动指定代理优先级
/configure --agent-priority "pm>architect>dev"

Q3: 检查清单验证不通过？ ​

bash
# 查看详细检查结果
/checklist result --detailed --name pm-checklist

# 逐项修复问题
/checklist fix --item "缺失的验收条件"

# 重新验证
/checklist rerun --name pm-checklist

性能优化建议 ​

1. 合理选择团队配置 ​

  • 小项目使用 team-ide-minimal.yaml
  • 避免过度配置导致的资源浪费

2. 模板使用优化 ​

  • 缓存常用模板结果
  • 增量更新而非完全重新生成

3. 批处理操作 ​

  • 合并相关操作减少上下文切换
  • 使用并行处理提高效率

最佳实践总结 ​

通用最佳实践 ​

  1. 渐进式采用: 从简单场景开始，逐步扩展使用
  2. 标准化流程: 建立团队统一的使用规范
  3. 持续优化: 基于使用反馈不断改进流程
  4. 知识积累: 记录和分享成功的使用模式

角色特定最佳实践 ​

  • 产品经理: 注重用户价值和商业目标
  • 架构师: 平衡技术复杂度和业务需求
  • 设计师: 用户体验和技术实现的平衡
  • 开发者: 代码质量和交付效率的平衡
  • 测试: 质量保证和交付速度的平衡

团队协作最佳实践 ​

  1. 清晰的角色定义: 明确每个角色的职责边界
  2. 有效的沟通机制: 建立定期的同步和反馈机制
  3. 共同的质量标准: 统一的质量要求和验收标准
  4. 持续的学习改进: 定期回顾和优化协作流程

用户使用指南 - 让每个角色都能高效使用Claude Code

Claude Code 使用指南

Copyright © 2025