Skip to content

Commands 命令系统总览

智能化的SOLO工作流控制命令集

🎯 命令系统设计哲学

Claude Code Commands 系统基于意图导向交互理论,每个命令都对应用户在SOLO工作流中的一个明确意图和认知需求。

核心设计原则

1. 认知负荷最小化

  • 单一职责:每个命令专注解决一个特定问题
  • 智能默认:基于上下文自动选择最合适的行为
  • 渐进式揭示:从简单到复杂的信息展示

2. 上下文感知

  • 状态检测:自动识别项目当前状态和阶段
  • 环境适配:根据项目类型和配置调整行为
  • 历史学习:从使用模式中学习用户偏好

3. 反馈导向

  • 即时反馈:命令执行后立即显示结果和影响
  • 预测性提示:基于当前状态建议下一步行动
  • 错误恢复:提供明确的错误处理和恢复建议

📋 四大核心命令详解

🚀 /solo - 主工作流命令

设计理念:一站式项目开发入口,智能化的工作流引导

命令形式

bash
/solo [项目描述]              # 新项目或继续现有项目
/solo                         # 继续当前项目的下一步工作
/solo --reset                 # 重置项目状态
/solo --help                  # 显示帮助信息

智能状态检测机制

核心功能

  • 智能阶段识别:自动检测当前应该执行的SOLO阶段
  • 上下文恢复:恢复之前的工作状态和思考过程
  • 增量工作:避免重复劳动,专注未完成部分
  • 质量保证:确保每个阶段达到质量标准后再推进

使用场景

  1. 新项目启动/solo "电商系统用户管理模块"
  2. 继续开发/solo (系统自动识别下一步)
  3. 中断恢复:项目被中断后重新开始工作
  4. 状态同步:团队成员之间的项目状态同步

📊 /solo__status - 多维度状态分析

设计理念:基于数据驱动的项目状态透明化,支持不同角色的信息需求

命令形式

bash
/solo__status brief           # 简要状态概览
/solo__status detailed        # 详细状态分析
/solo__status dashboard       # 可视化仪表板
/solo__status role:dev        # 开发者视角
/solo__status role:pm         # 产品经理视角
/solo__status role:qa         # QA工程师视角
/solo__status diagnose        # 系统诊断模式
/solo__status performance     # 性能分析

多维度状态分析框架

角色定制视图

开发者视图 (role:dev)

  • 🛠️ 当前开发任务和优先级
  • 📊 代码质量和测试覆盖率
  • 🔧 技术债务和重构建议
  • ⚡ 性能指标和优化建议

产品经理视图 (role:pm)

  • 🎯 功能完成度和里程碑进展
  • 👥 用户故事完成状态
  • 📈 产品指标和用户反馈
  • 🔄 需求变更影响分析

QA工程师视图 (role:qa)

  • 🧪 测试执行状态和覆盖率
  • 🐛 缺陷发现和修复趋势
  • ✅ 质量关卡和发布准备度
  • 📋 测试计划和执行建议

🔄 /solo__switch - 智能模式切换

设计理念:基于风险评估的安全阶段切换,防止质量问题和返工

命令形式

bash
/solo__switch architect       # 切换到架构设计阶段
/solo__switch engineer        # 切换到工程实现阶段
/solo__switch qa             # 切换到质量保证阶段
/solo__switch auto           # 自动选择最佳阶段
/solo__switch --force        # 强制切换(跳过检查)
/solo__switch --dry-run      # 预演切换(不实际执行)
/solo__switch --assess-risk  # 详细风险评估

风险评估矩阵

安全检查机制

  • 🔒 质量门禁:确保当前阶段达到最低质量标准
  • ⚠️ 风险预警:识别可能导致问题的切换操作
  • 🛡️ 回滚保护:提供快速回到安全状态的机制
  • 📊 影响分析:量化切换对整体项目的影响

🔧 /solo__resume - 智能中断恢复

设计理念:基于上下文分析的智能工作恢复,最小化中断损失

命令形式

bash
/solo__resume deep           # 深度分析后恢复
/solo__resume quick          # 快速恢复当前上下文
/solo__resume verify         # 验证环境一致性后恢复
/solo__resume diagnose       # 诊断中断原因
/solo__resume --from=date    # 从特定时间点恢复

中断原因分析框架

恢复策略

  • 🧠 上下文重建:从文档和代码历史重建思考过程
  • 🔍 变更检测:识别中断期间的环境和需求变化
  • 📝 状态同步:更新项目状态以反映当前现实
  • 🎯 优先级重排:基于新情况调整工作优先级

🎛️ 命令协作机制

命令间的协作模式

数据共享机制

所有命令共享统一的项目状态存储:

.solo/
├── .solo-metadata.json      # 项目元数据和状态
├── contexts/                 # 命令执行上下文
│   ├── solo-context.json
│   ├── status-context.json
│   ├── switch-context.json
│   └── resume-context.json
├── logs/                     # 命令执行日志
│   ├── command-history.log
│   ├── state-changes.log
│   └── performance.log
└── cache/                    # 命令结果缓存
    ├── status-cache.json
    ├── analysis-cache.json
    └── metrics-cache.json

🚀 高级使用模式

1. 工作流自动化

bash
# 自动化的一天工作流
alias morning="solo__status dashboard && solo"
alias checkin="solo__status brief && git commit -m 'Daily progress'"
alias evening="solo__status performance && solo__switch auto"

2. 团队协作模式

bash
# 团队状态同步
solo__status detailed --export=slack  # 发送到Slack频道
solo__status role:pm --format=report  # 生成PM报告
solo__switch --team-mode              # 团队切换模式

3. 持续集成集成

yaml
# CI/CD 流水线集成
- name: SOLO Quality Check
  run: |
    solo__status diagnose --exit-on-failure
    solo__switch qa --verify-readiness

📊 命令性能和监控

执行性能指标

  • 响应时间:命令执行到结果返回的时间
  • 🧠 上下文加载:项目状态和历史的加载时间
  • 💾 内存使用:命令执行期间的内存占用
  • 📊 准确率:状态检测和建议的准确性

使用分析

  • 📈 使用频率:各命令的调用频率统计
  • 🎯 成功率:命令执行成功率和失败原因
  • 🔄 工作流模式:常见的命令使用序列
  • 👥 用户行为:不同用户的使用习惯分析

🛠️ 扩展和自定义

自定义命令开发

markdown
# 创建自定义命令
claude-settings/commands/my-command.md

# 命令定义结构
- 命令名称和描述
- 参数和选项定义  
- 执行逻辑和代理协作
- 错误处理和恢复
- 帮助文档和示例

插件机制

  • 🔌 命令插件:扩展现有命令功能
  • 🎛️ 状态提供者:自定义状态数据来源
  • 📊 报告生成器:定制化报告格式
  • 🔔 通知处理器:集成外部通知系统

📚 相关资源

命令深度指南

集成文档

最佳实践


💡 核心理念: Commands系统的设计核心是认知辅助——不是替代用户思考,而是减少认知负荷,让用户专注于创造性工作。每个命令都是用户意图的智能化执行器。

SOLO Development Guide