command-guide

Claude Code 命令选择指南

此技能可帮助你根据不同场景选择最合适的命令、Agent 或技能。

快速决策流程图

graph TD
    A[User Request] --> B{Request Type?}
    B -->|New Feature| C[/plan]
    B -->|Bug Fix| D[/tdd or build-error-resolver]
    B -->|Code Review| E[/code-review or code-reviewer agent]
    B -->|Testing| F[/e2e or tdd-guide agent]
    B -->|Context Too Long| G[/compact]
    B -->|Documentation| H[/docs or docs-lookup agent]
    B -->|Looping Task| I[/loop]
    B -->|Security Review| J[security-reviewer agent]

    C --> K[planner agent]
    D --> L{Build Failed?}
    L -->|Yes| M[build-error-resolver]
    L -->|No| N[tdd-guide]
    E --> O[code-reviewer]
    F --> P[e2e-runner]

1. 内置斜杠命令

会话管理命令

命令	使用场景	示例
/compact	上下文过长（>150K 个 token）、响应缓慢、任务阶段转换	/compact 或自动触发
/clear	开始全新对话、清除历史记录	/clear
/loop	定期执行任务、自动循环工作	/loop 5m check build status
/help	查看帮助、了解命令	/help
/fast	需要更快的响应（仅限 Opus 4.6）	/fast
/model	切换模型	/model sonnet

开发工作流命令

命令	使用场景	激活时机
/plan	开始新功能、架构重构、复杂任务	进入规划模式
/tdd	编写测试、TDD 开发工作流	需要测试指导时
/e2e	E2E 测试、关键用户流程验证	需要浏览器测试时
/code-review	代码质量审查	编写代码后
/build-fix	构建失败、类型错误	构建失败时
/learn	从会话中提取模式、学习	会话结束前
/skill-create	根据 git 历史记录创建新技能	发现重复模式时

文档与查询命令

命令	使用场景	示例
/docs	更新项目文档	/docs
/update-codemaps	更新代码映射	/update-codemaps
/remember	将记忆保存到记忆系统	/remember user prefers concise output
/tasks	查看任务列表	/tasks

---

2. Agent 选择

开发工作流 Agent

Agent	触发条件	目的
planner	复杂功能需求、架构决策	制定实施计划
architect	系统设计、技术栈选择	架构分析与决策
tdd-guide	新功能、Bug 修复	提供 TDD 工作流指导
code-reviewer	编写代码后立即调用	代码质量审查
security-reviewer	处理身份验证、API、敏感数据	检测安全漏洞

问题解决 Agent

Agent	触发条件	目的
build-error-resolver	构建失败时立即调用	修复构建／类型错误
e2e-runner	关键用户流程、PR 前	执行 E2E 测试
refactor-cleaner	代码维护、清理无用代码	检测并清理无用代码
doc-updater	更新文档、代码映射	同步文档

研究与探索 Agent

Agent	触发条件	目的
Explore	探索代码库、查找文件	快速探索代码库
general-purpose	复杂的多步骤任务	处理一般任务
docs-lookup	查询库／框架文档	获取最新 API 文档

---

3. 技能选择

工作流技能

技能	触发时机	目的
tdd-workflow	开发新功能／修复 Bug 时	提供完整的 TDD 工作流指导
verification-loop	功能完成后、PR 前	全面验证（构建／测试／lint／安全）
strategic-compact	会话较长、上下文压力较大时	指导何时手动执行 /compact

架构与模式技能

技能	触发时机	目的
frontend-patterns	前端开发	React／Next.js／Vue 最佳实践
backend-patterns	后端开发	API／服务架构模式
api-design	API 设计	RESTful／API 设计规范
mcp-server-patterns	MCP 服务开发	MCP 配置与模式

测试技能

技能	触发时机	用途
e2e-testing	需要 E2E 测试时	生成 Playwright 测试
security-review	需要安全审查时	检测 OWASP Top 10

研究技能

技能	触发时机	用途
deep-research	需要深入研究时	多轮搜索与研究
exa-search	需要网页搜索时	搜索网页内容
documentation-lookup	查询库文档时	查询 Context7 文档

---

4. 场景决策矩阵

按任务阶段划分

阶段	推荐工具组合	原因
需求分析	planner + Explore	先规划，再探索
架构设计	architect + api-design skill	提供专业的架构指导
开发前	tdd-guide + tdd-workflow skill	先编写测试
开发期间	直接编辑 + 快速迭代	保持开发节奏
开发后	code-reviewer + verification-loop	质量把关
测试阶段	e2e-runner + e2e-testing skill	完整的测试覆盖
提交 PR 前	security-reviewer + verification-loop	最终验证
构建失败	build-error-resolver	针对性修复

按问题类型划分

问题	立即调用	备注
构建失败	build-error-resolver	尽量少改动，快速修复
类型错误	build-error-resolver	TypeScript 专家
修复错误	tdd-guide	先编写测试，再修复
安全漏洞	security-reviewer	检测 OWASP 漏洞
代码质量差	code-reviewer	立即审查
缺少文档	doc-updater	自动更新
死代码	refactor-cleaner	安全清理

按开发类型划分

开发类型	技能组合
前端功能	frontend-patterns + tdd-workflow
后端 API	backend-patterns + api-design + tdd-workflow
MCP 服务	mcp-server-patterns + tdd-workflow
数据库	database-reviewer agent
安全功能	security-reviewer + security-review skill

---

5. 并行执行策略

可并行的场景

建议同时启动多个互相独立的任务

场景：代码完成后准备提交 PR

• Agent 1：code-reviewer（代码质量）
• Agent 2：security-reviewer（安全审查）
• Agent 3：e2e-runner（E2E 测试）

场景：大型重构分析

• Agent 1：architect（架构分析）
• Agent 2：Explore（代码探索）
• Agent 3：refactor-cleaner（检测死代码）

需要按顺序执行

无法并行：存在依赖关系

场景：修复构建错误

• 顺序：build-error-resolver -> 测试验证 -> code-reviewer

场景：开发新功能

• 顺序：planner -> tdd-guide（编写测试）-> 实现 -> code-reviewer

---

6. 自动触发规则

无需用户请求即可调用

情况	自动操作
编写或修改代码	立即调用 code-reviewer
构建失败	立即调用 build-error-resolver
复杂功能请求	立即调用 planner
处理身份验证或敏感数据	立即调用 security-reviewer
新功能或错误修复	立即调用 tdd-guide
架构决策	立即调用 architect

---

7. 上下文管理时机

指标	触发 /compact
Token > 150K	立即压缩
响应缓慢	建议压缩
任务阶段切换	在阶段边界处压缩
完成重要里程碑	压缩后继续
调试结束 -> 新任务	清除调试记录

最佳实践：

• 调研后、实现前进行压缩（保留计划）
• 完成里程碑后进行压缩（清除中间状态）
• 不要在实现过程中压缩（会丢失变量/路径）

---

8. 命令速查表

Development Workflow:
/plan        -> Enter planning mode (complex tasks)
/tdd         -> TDD workflow
/e2e         -> E2E testing
/code-review -> Code review
/build-fix   -> Fix build

Session Management:
/compact     -> Compact context
/clear       -> Clear session
/loop        -> Looping task
/fast        -> Fast mode

Documentation & Memory:
/docs        -> Update docs
/remember    -> Save memory
/tasks       -> View tasks

Help:
/help        -> View all commands

---

9. 使用示例

示例 1：开发新功能

用户：添加用户身份验证功能

工作流：

1. /plan -> planner agent 创建计划
2. tdd-guide -> 编写测试
3. 实现 -> 编辑代码
4. code-reviewer -> 代码审查
5. security-reviewer -> 安全审查（身份验证较敏感）
6. e2e-runner -> E2E 测试
7. /compact -> 完成里程碑后压缩

示例 2：构建失败

用户：npm run build 失败

工作流：

1. build-error-resolver -> 分析错误并进行最小修复
2. 验证构建成功
3. code-reviewer -> 检查修复质量

示例 3：重构代码

用户：重构身份验证模块

工作流：

1. architect -> 架构分析
2. planner -> 实施计划
3. refactor-cleaner -> 检测死代码
4. tdd-guide -> 确保测试覆盖率
5. 实现 -> 重构代码
6. verification-loop -> 全面验证

---

核心原则：

1. 先规划，后实现——复杂任务使用 /plan
2. 先测试——新功能使用 tdd-guide
3. 编码后立即审查——代码完成后使用 code-reviewer
4. 构建失败时立即修复——使用 build-error-resolver
5. 审查敏感代码——身份验证/API 使用 security-reviewer
6. PR 前全面验证——使用 verification-loop