使用指南

从零开始掌握Claude Code SOLO系统，实现高效的产品开发

🚀 快速开始

第一个SOLO项目

让我们通过一个完整的示例，了解SOLO系统的使用流程：

项目启动需求分析阶段架构设计阶段

bash

# 1. 创建项目目录
mkdir todo-api && cd todo-api

# 2. 启动SOLO工作流
/solo "创建一个简单的待办事项API，支持增删改查操作"

# 系统响应：
# 🎯 SOLO 智能工作模式启动
# 检测到全新项目，进入PRODUCT阶段
# 正在调用 product-manager agent...

bash

# product-manager agent 开始工作：
# 
# 📋 产品需求分析
# 我将引导您完成产品需求的详细分析...
# 
# 🎯 需求澄清问题：
# 1. 这个待办事项API的主要用户是谁？
# 2. 用户希望通过这个API解决什么核心问题？
# 3. 除了基本的CRUD操作，还需要哪些功能？
# 4. 有什么特殊的性能或安全要求吗？
# 
# [与用户进行需求澄清对话...]
# 
# ✅ 生成 .solo/docs/PRD.md 文档
# ✅ 自动切换到 ARCHITECT 阶段

bash

# architect agent 基于PRD工作：
# 
# 🏗️ 技术架构设计
# 基于产品需求文档，开始技术架构设计...
# 
# 📊 技术栈选择：
# - 后端：Node.js + Express + TypeScript
# - 数据库：SQLite (开发) / PostgreSQL (生产)
# - 测试：Jest + Supertest
# - 文档：OpenAPI 3.0
# 
# 📋 任务分解：
# - TASK001: 数据模型设计和数据库初始化
# - TASK002: RESTful API 路由设计
# - TASK003: 业务逻辑层实现
# - TASK004: 数据访问层实现
# - TASK005: API 集成测试
# 
# ✅ 生成 .solo/docs/PROJECT_PLAN.md
# ✅ 生成 .solo/docs/DECISIONS.md
# ✅ 自动切换到 ENGINEER 阶段

开发实现阶段

TDD开发循环重构优化

bash

# engineer agent 开始TDD实现：

# 🔴 RED阶段 - 编写失败测试
# 正在为 TASK001 编写测试用例...

# 📝 创建 __tests__/todo.model.test.ts
describe('Todo Model', () => {
  it('should create a todo with required fields', () => {
    const todo = new Todo('Buy groceries', 'Shopping for dinner');
    expect(todo.title).toBe('Buy groceries');
    expect(todo.description).toBe('Shopping for dinner');
    expect(todo.completed).toBe(false);
    expect(todo.id).toBeDefined();
    expect(todo.createdAt).toBeInstanceOf(Date);
  });
});

# ❌ 测试运行失败 (预期)
# Error: Cannot find module '../src/models/Todo'

# 🟢 GREEN阶段 - 实现最小代码
# 正在实现 Todo 模型...

# 📝 创建 src/models/Todo.ts
export class Todo {
  public id: string;
  public createdAt: Date;

  constructor(
    public title: string,
    public description: string,
    public completed: boolean = false
  ) {
    this.id = Date.now().toString();
    this.createdAt = new Date();
  }
}

# ✅ 测试通过

bash

# 🔄 REFACTOR阶段 - 代码重构

# 改进 Todo 模型结构...
export interface ITodo {
  id: string;
  title: string;
  description: string;
  completed: boolean;
  createdAt: Date;
  updatedAt: Date;
}

export class Todo implements ITodo {
  public readonly id: string;
  public readonly createdAt: Date;
  public updatedAt: Date;

  constructor(
    public title: string,
    public description: string,
    public completed: boolean = false
  ) {
    this.id = generateUniqueId();
    this.createdAt = new Date();
    this.updatedAt = new Date();
  }

  public markCompleted(): void {
    this.completed = true;
    this.updatedAt = new Date();
  }
}

# ✅ 所有测试仍然通过
# ✅ 保存上下文到 .solo/contexts/CONTEXT_TASK001.md

质量保证阶段

质量检查

bash

# 所有核心功能实现完成，自动切换到 QA 阶段
# qa-engineer agent 开始工作：

# 🧪 质量保证分析
# 正在进行全面的质量检查...

# 📊 测试覆盖率分析：
# - 行覆盖率: 87% (目标: >80%) ✅
# - 分支覆盖率: 82% (目标: >70%) ✅
# - 函数覆盖率: 95% ✅

# 🔍 代码审查结果：
# - 代码规范符合 TypeScript 最佳实践 ✅
# - 无安全漏洞发现 ✅
# - 性能指标符合要求 ✅
# - API 文档完整 ✅

# 📋 端到端测试：
# - POST /api/todos - 创建待办事项 ✅
# - GET /api/todos - 获取待办事项列表 ✅
# - GET /api/todos/:id - 获取单个待办事项 ✅
# - PUT /api/todos/:id - 更新待办事项 ✅
# - DELETE /api/todos/:id - 删除待办事项 ✅

# ✅ 生成 .solo/reports/tests/TEST_SUMMARY.md
# ✅ 所有质量门控检查通过
# 🎉 项目开发完成！

📊 项目状态管理

实时状态监控

快速状态检查角色专属视图

bash

/solo__status brief

# 输出：
# 🎯 项目: 待办事项API | 阶段: QA | 进度: 95%
# ⚡ 关键指标: 完成 5 | 进行中 0 | 风险 0
# 🎺 下一步: 准备项目交付文档
# ⏱️ 预计完成: 今天 (95%置信度)

bash

# 开发者视图
/solo__status role:dev
# 📊 开发者专属状态
# ### 当前任务状态
# - 所有核心任务已完成
# - TDD状态: 完整循环完成
# - 测试覆盖率: 87% (优秀)
# 
# ### 代码指标
# - 代码行数: 245 (测试: 180)
# - 代码复杂度: 6.2 (优秀, <10)
# - 技术债务: 0个问题
# - 代码审查: 已通过
# 
# ### 下一步行动
# 1. 准备部署配置 - 预计时间: 30分钟
# 2. 编写API使用文档 - 预计时间: 45分钟

# 产品经理视图  
/solo__status role:pm
# 📊 产品经理专属状态
# ### 需求管理
# - PRD完整度: 100%
# - 用户故事: 完成 5/5
# - 需求变更: 0个
# 
# ### 交付状态
# - MVP进度: 100% (已完成)
# - 功能优先级: P0(5) 全部完成
# - 用户验收: 待验收
# 
# ### 产品健康度
# - 核心功能覆盖: 100%
# - API性能达标: 是
# - 安全检查通过: 是

数据驱动的项目洞察

数据仪表板

bash

/solo__status dashboard

# 📊 SOLO项目数据仪表板
# 
# ### 关键绩效指标 (KPI)
# | 指标 | 当前值 | 目标值 | 趋势 | 状态 |
# |------|--------|--------|------|------|
# | 整体进度 | 95% | 100% | ↗️ | 🟢 |
# | 代码质量 | 8.7/10 | 8.0+ | ↗️ | 🟢 |
# | 测试覆盖 | 87% | 80% | ↗️ | 🟢 |
# | 交付速度 | 5任务/天 | 3任务/天 | ↗️ | 🟢 |
# 
# ### 预测分析
# - **完成时间预测**: 2024-02-20 14:30 (置信区间: 95%)
# - **资源需求预测**: 2人天 (基于历史数据)
# - **风险概率**: 延期 5% | 质量问题 2% | 资源不足 0%
# 
# ### 改进建议
# 1. 性能测试覆盖 - 预期提升: 质量保证+15%
# 2. API文档自动化 - 预期提升: 维护效率+25%

🔄 高级工作流程

智能模式切换

需求变更处理智能推荐模式

bash

# 场景：客户要求添加用户认证功能

/solo__switch product
# 执行安全检查...
# ⚠️ 检测到已有实现代码，切换到PRODUCT阶段可能影响：
# - 已完成的5个任务实现
# - 87%的测试覆盖率
# - 当前的API接口设计
# 
# 💡 建议操作：
# 1. 备份当前进度到 .solo/backups/
# 2. 创建PRD补充文档处理新需求
# 3. 评估对现有架构的影响
# 
# 确认切换? (y/N)

# 用户确认后：
# ✅ 已备份当前状态
# ✅ 切换到 product-manager agent
# 📋 开始收集用户认证需求...

bash

/solo__switch auto

# 🤖 项目状态智能分析
# 
# 📊 分析结果：
# - 当前阶段: QA (95%完成)
# - 主要任务: 质量检查已基本完成
# - 待处理项: 部署准备和文档完善
# 
# 💡 推荐操作：
# **主要建议**: 保持当前QA阶段，完成最后的质量检查
# - 优势：项目即将完成，不建议切换
# - 剩余工作：准备生产部署配置
# 
# **替代选择**: 
# 1. engineer模式 - 处理部署脚本编写
# 2. general-purpose模式 - 协调部署准备工作
# 
# **风险评估**: 切换风险极低，建议继续当前工作

中断恢复处理

快速恢复深度恢复分析

bash

# 场景：第二天继续昨天的工作

/solo__resume quick
# 🚀 快速恢复检查清单
# ✅ 环境状态: 正常
# ✅ 依赖完整性: Node.js 18.17.0, 所有包正常
# ✅ Git工作区: clean, 无未提交变更
# ✅ 最后工作点: TASK005 - API集成测试完成
# 
# 📋 工作上下文恢复：
# - 项目：待办事项API
# - 当前阶段：QA (95%完成)
# - 下一步：准备部署配置和API文档
# 
# ⏱️ 预计恢复时间: 2分钟
# 🎯 建议操作: 继续QA阶段，完成项目交付准备

# 自动继续工作...
/solo

bash

# 场景：一周后回到项目

/solo__resume deep
# 🔬 深度恢复分析报告
# 
# ### 中断分析
# - 中断时长: 7天
# - 中断原因: 其他优先项目
# - 影响评估: 低 (无环境变化)
# 
# ### 环境变化检测
# - Node.js: 18.17.0 → 18.19.1 (小版本更新)
# - 依赖包: Jest 29.5.0 → 29.7.0 (可选更新)
# - 系统环境: 无重大变化
# 
# ### 上下文重建
# - 工作记忆恢复: 最后完成API集成测试
# - 决策链重建: TypeScript+Express技术栈选择原因
# - 问题上下文: 无未解决问题
# 
# ### 恢复风险
# - 🟢 低风险: 项目状态稳定，环境变化最小
# 
# ### 恢复策略
# 1. 可选依赖更新 - 时间: 5分钟
# 2. 验证测试环境 - 时间: 3分钟
# 3. 重新执行最后测试 - 时间: 2分钟
# ⏱️ 预计总恢复时间: 10分钟

🎯 最佳实践指南

✅ 推荐的工作流程

项目启动

bash

# 使用描述性的项目说明
/solo "创建一个电商平台的用户评价系统，支持星级评分、文字评价和图片上传"

需求阶段
- 积极参与product-manager的需求澄清对话
- 提供具体的使用场景和示例
- 明确非功能需求（性能、安全、可用性）
开发阶段
- 信任engineer agent的TDD流程
- 定期检查代码质量和测试覆盖率
- 保持commits的合理粒度
质量阶段
- 认真对待qa-engineer的质量检查建议
- 确保所有质量门控都通过
- 准备完整的项目交付文档

⚠️ 常见误区和避免方法

避免这些问题

❌ 频繁手动切换模式

问题：破坏SOLO的智能流程
解决：信任系统的自动切换，只在特殊情况使用/solo__switch

❌ 跳过需求分析阶段

问题：后期需求变更成本高
解决：花足够时间完善PRD，明确验收标准

❌ 忽略测试覆盖率

问题：质量问题在后期暴露
解决：严格遵循TDD，保持80%+覆盖率

❌ 不保存工作上下文

问题：中断后难以恢复工作状态
解决：定期使用/solo__status检查，关键节点手动保存

📊 效率优化技巧

提升开发效率

利用状态检查

bash

# 每日开始工作前
/solo__resume quick
/solo__status role:dev

角色视图切换

bash

# 根据当前关注点切换视图
/solo__status role:pm    # 关注需求和交付
/solo__status role:dev   # 关注代码和任务
/solo__status role:qa    # 关注质量和测试

数据驱动决策

bash

# 项目关键节点使用
/solo__status dashboard  # 全面的数据分析

🔧 自定义和扩展

团队配置定制

团队配置文件项目特定配置

yaml

# .solo/config/team-settings.json
{
  "team": {
    "name": "产品开发团队",
    "timezone": "Asia/Shanghai",
    "workingHours": "09:00-18:00"
  },
  "quality": {
    "testCoverageThreshold": 85,
    "codeComplexityLimit": 8,
    "requireCodeReview": true
  },
  "workflow": {
    "autoProgressToNextPhase": true,
    "requireExplicitApproval": ["ARCHITECT", "QA"],
    "enableContinuousIntegration": true
  }
}

yaml

# .solo/config/project-settings.json
{
  "project": {
    "name": "待办事项API",
    "type": "backend-api",
    "technology": "nodejs-typescript"
  },
  "agents": {
    "engineer": {
      "preferredTestFramework": "jest",
      "codeStyle": "airbnb",
      "enableAutoRefactor": true
    },
    "architect": {
      "preferredDatabase": "postgresql",
      "apiStyle": "rest",
      "generateOpenAPISpec": true
    }
  }
}

集成第三方工具

Git集成CI/CD集成

bash

# 自动提交SOLO文档到版本控制
git add .solo/docs/
git commit -m "docs: update SOLO project documentation

- Updated PRD with user authentication requirements
- Revised architecture design for security integration
- Added technical decisions for JWT implementation

🤖 Generated with Claude Code SOLO system"

bash

# GitHub Actions工作流
name: SOLO Quality Check
on: [push, pull_request]

jobs:
  solo-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Verify SOLO Project Structure
        run: |
          if [ -d ".solo" ]; then
            echo "✅ SOLO project detected"
            /solo__status brief
          fi
      - name: Run Quality Gates
        run: |
          npm test -- --coverage
          npm run lint

📞 获取帮助和支持

🛠️ 自助诊断工具

bash

# 全面系统诊断
/solo__status diagnose

# 环境一致性检查
/solo__resume verify

# 配置验证
/config

# 查看可用agents
/agents

📚 学习资源

进阶教程: Commands详解 | Agents配置
示例项目: Java Spring | Python FastAPI | TypeScript Express
最佳实践: 团队协作 | 故障排除

🎉 恭喜！您已掌握Claude Code SOLO系统的基本使用方法。开始您的高效开发之旅吧！

使用指南 ​

🚀 快速开始 ​

第一个SOLO项目 ​

开发实现阶段 ​

质量保证阶段 ​

📊 项目状态管理 ​

实时状态监控 ​

数据驱动的项目洞察 ​

🔄 高级工作流程 ​

智能模式切换 ​

中断恢复处理 ​

🎯 最佳实践指南 ​

✅ 推荐的工作流程 ​

⚠️ 常见误区和避免方法 ​

📊 效率优化技巧 ​

🔧 自定义和扩展 ​

团队配置定制 ​

集成第三方工具 ​

📞 获取帮助和支持 ​

🛠️ 自助诊断工具 ​

📚 学习资源 ​

使用指南

🚀 快速开始

第一个SOLO项目

开发实现阶段

质量保证阶段

📊 项目状态管理

实时状态监控

数据驱动的项目洞察

🔄 高级工作流程

智能模式切换

中断恢复处理

🎯 最佳实践指南

✅ 推荐的工作流程

⚠️ 常见误区和避免方法

📊 效率优化技巧

🔧 自定义和扩展

团队配置定制

集成第三方工具

📞 获取帮助和支持

🛠️ 自助诊断工具

📚 学习资源