🚀 SOLO 开发指南

Appearance

Commands 命令系统 ​

SOLO工作模式的智能化命令接口，提供直观的用户交互体验

📋 命令概览 ​

Claude Code SOLO系统提供4个核心Commands，每个命令都经过智能化升级，具备状态感知和风险评估能力。

🎯 命令架构 ​

🚀 核心Commands详解 ​

/solo - 智能主工作流 ​

智能化特性：

  • ✅ 状态感知: 自动检测项目当前阶段
  • ✅ 连续性保证: 避免重复工作，智能继续
  • ✅ 上下文传承: 完整保持工作记忆
bash
/solo "创建一个用户管理系统"
# → 检测到全新项目，启动PRODUCT阶段
# → 自动调用 product-manager agent
# → 生成完整 PRD.md 文档
bash
/solo
# → 检测到PRD已完成，继续ARCHITECT阶段
# → 自动调用 architect agent
# → 基于PRD生成技术方案
bash
/solo "添加团队协作功能"
# → 检测到新需求，智能回到PRODUCT阶段
# → 补充PRD文档内容
# → 更新架构设计

状态判断逻辑：

if (.solo目录不存在) {
    → 全新项目，启动PRODUCT阶段
} else if (PRD.md缺失或不完整) {
    → 继续PRODUCT阶段，完善需求文档
} else if (PROJECT_PLAN.md缺失) {
    → 进入ARCHITECT阶段，基于PRD设计架构
} else if (存在待实现任务) {
    → 进入ENGINEER阶段，继续TDD开发
} else {
    → 项目健康，提供状态报告和优化建议
}

/solo__status - 多维度状态分析 ​

智能化特性：

  • ✅ 角色定制: 不同角色的专属视图
  • ✅ 数据洞察: 基于历史数据的趋势分析
  • ✅ 预测分析: 完成时间和风险概率预测
bash
/solo__status brief
# 输出：
# 🎯 项目: 用户管理系统 | 阶段: ENGINEER | 进度: 65%
# ⚡ 关键指标: 完成 8 | 进行中 2 | 风险 1
# 🎺 下一步: 完成用户认证模块测试
# ⏱️ 预计完成: 2024-02-15 (85%置信度)
bash
/solo__status role:dev
# 开发者专属状态：
# - 当前任务状态和TDD进度
# - 代码指标和技术债务
# - 下一步具体行动建议

/solo__status role:pm  
# 产品经理视图：
# - 需求管理和用户故事进度
# - 交付状态和产品健康度
# - MVP进度和功能优先级

/solo__status role:qa
# QA工程师视图：
# - 测试执行状态和覆盖率
# - 质量指标和风险评估
# - 质量改进建议
bash
/solo__status dashboard
# 生成完整的KPI仪表板：
# - 关键绩效指标趋势图
# - 预测分析和风险概率
# - 改进建议和行动计划

/solo__switch - 智能强制切换 ​

智能化特性：

  • ✅ 风险评估: 切换前的安全检查
  • ✅ 数据保护: 自动备份和恢复机制
  • ✅ 智能推荐: 基于项目状态的最佳切换建议
bash
/solo__switch architect
# 执行流程：
# 1. 安全检查 - 分析当前状态和切换风险
# 2. 数据备份 - 保护当前工作进度  
# 3. 切换执行 - 调用architect agent
# 4. 状态更新 - 记录切换原因和结果
bash
/solo__switch auto
# 分析项目状态，推荐最适合的模式：
# 📊 分析结果：
# - 当前阶段: ENGINEER (进行中)
# - 建议操作: 继续当前开发任务
# - 替代选择: qa (开始质量检查)
# - 风险评估: 切换风险低
bash
/solo__switch qa
# 紧急质量补救模式：
# ⚠️ 检测到质量问题，建议立即处理
# 1. 分析测试覆盖率缺口
# 2. 优先补充关键测试用例
# 3. 建立质量基线标准

切换安全检查：

/solo__resume - 智能中断恢复 ​

智能化特性：

  • ✅ 中断检测: 自动识别中断原因和影响
  • ✅ 环境验证: 确保开发环境一致性
  • ✅ 上下文重建: 智能恢复工作记忆
bash
/solo__resume quick
# 适用于短期中断 (<24小时)
# ✅ 环境状态: 正常
# ✅ 依赖完整性: 已验证
# ✅ 代码同步: Git状态正常
# ✅ 最后工作点: TASK003 - 用户认证接口实现
# 下一步: 继续TDD循环，实现密码验证逻辑
# 预计恢复时间: 5分钟
bash
/solo__resume deep
# 适用于长期中断 (>1周)
# 📊 中断分析：
# - 中断时长: 12天
# - 中断原因: 项目优先级调整
# - 影响评估: 中等 (依赖更新，环境变化)
# 
# 🔍 环境变化检测：
# - Node.js: 18.12.0 → 18.19.0
# - 依赖更新: 3个包有更新
# - 系统环境: 无重大变化
# 
# 🔄 恢复策略：
# 1. 更新依赖包 - 时间: 10分钟
# 2. 验证测试环境 - 时间: 5分钟  
# 3. 重建工作上下文 - 时间: 15分钟
bash
/solo__resume verify
# 专注于状态一致性验证
# 📋 项目完整性验证报告：
# 
# ✅ 文件系统检查：
# - 核心文件完整性: 正常
# - 配置文件一致性: 正常
# - 依赖关系: 3个更新可用
# 
# ✅ 代码状态验证：
# - Git工作区: clean
# - 分支状态: main/origin同步
# - 未提交变更: 无
# 
# ✅ 测试环境验证：
# - 测试可执行性: 正常
# - 覆盖率数据: 82% (最新)
# - 构建环境: 正常

🎛️ 命令使用策略 ​

使用场景决策树 ​

命令组合使用 ​

高效工作流程

bash
# 1. 每日工作开始
/solo__resume quick          # 快速恢复昨天的工作状态
/solo                        # 继续推进项目

# 2. 遇到问题时
/solo__status diagnose       # 诊断问题原因
/solo__switch debugger       # 切换到调试模式

# 3. 阶段完成检查
/solo__status role:qa        # QA视角检查质量
/solo__switch qa             # 进入质量保证阶段

# 4. 项目汇报准备
/solo__status dashboard      # 生成完整数据报告

📊 命令性能优化 ​

响应时间优化 ​

命令平均响应时间优化建议
/solo2-5秒状态检查缓存，避免重复分析
/solo__status brief1-2秒快速概览，最小数据查询
/solo__status dashboard10-15秒复杂分析，建议异步执行
/solo__switch3-8秒安全检查必要，可并行化
/solo__resume deep15-30秒深度分析，提供进度反馈

使用最佳实践 ​

注意事项

  • 避免频繁切换: 每次切换都有成本，建议完成当前阶段后再切换
  • 合理使用dashboard: 数据分析较重，建议在关键节点使用
  • 及时保存状态: 长时间工作后建议主动保存上下文

🔧 自定义Commands ​

创建自定义命令 ​

markdown
---
allowed-tools: Read, Write, TodoWrite
description: 自定义SOLO命令示例
argument-hint: [参数说明] - 参数的使用说明
---

# 自定义命令标题

命令的详细说明和使用方法...

## 执行逻辑

具体的命令执行步骤...

Commands开发规范 ​

  1. YAML头部: 必须包含name, description, tools
  2. 参数处理: 使用$ARGUMENTS获取用户输入
  3. 错误处理: 提供友好的错误提示
  4. 状态管理: 正确更新项目状态
  5. 文档完整: 包含使用示例和注意事项

📈 Commands统计分析 ​

使用频率统计 ​

基于实际使用数据的Commands使用频率：

用户偏好分析 ​

  • 新手用户: 更多使用/solo和/solo__status brief
  • 经验用户: 频繁使用/solo__switch和角色视图
  • 团队leader: 偏好dashboard和数据分析功能

🎯 掌握Commands系统，享受智能化的开发体验！

SOLO Development Guide

Copyright © 2024 Team