何时使用
- 面对一项任务,不确定该选哪个斜杠命令、Agent 还是 Skill 时。
- 想快速查
/plan、/tdd、/compact、/loop等命令的适用场景与触发时机时。 - 需要按「任务阶段 / 问题类型 / 开发类型」给出推荐工具组合时。
- 想要一份命令速查表或决策路径图时。
不该用的边界:
- 本条只负责「选哪个」与「何时触发」,不替代被选中命令/Agent 的实际执行。真正干活时切到对应工具。
- 不同环境装的命令/Agent 可能不同,先用
/help核实本机实际可用项,本表为通用参考。
步骤
- 判断请求类型:新功能 / Bug 修复 / 代码审查 / 测试 / 上下文过长 / 文档 / 循环任务 / 安全审查。
- 按下方决策路径定位首选命令或 Agent。
- 若任务跨多个阶段,参考「场景决策矩阵」组合工具(计划在前、测试在中、审查在后)。
- 判断可否并行:独立任务并行,有依赖则串行。
- 执行后按「上下文管理时机」决定是否
/compact。
指令
决策路径(核心分支):
用户请求
├─ 新功能 → /plan(进入 Plan 模式)→ planner
├─ Bug 修复 → /tdd(先写测试)或 build-error-resolver
├─ 代码审查 → /code-review 或 code-reviewer
├─ 测试 → /e2e 或 tdd-guide
├─ 上下文过长 → /compact
├─ 文档 → /docs 或 docs-lookup
├─ 循环任务 → /loop
└─ 安全审查 → security-reviewer
命令速查表:
开发工作流:
/plan 进入计划模式(复杂任务)
/tdd TDD 工作流
/e2e 端到端测试
/code-review 代码审查
/build-fix 修复构建
会话管理:
/compact 压缩上下文
/clear 清空会话
/loop 循环任务,如:/loop 5m check build status
/fast 快速模式(仅 Opus 4.6)
/model 切换模型,如:/model sonnet
文档与记忆:
/docs 更新文档
/remember 保存记忆
/tasks 查看任务
帮助:
/help 查看全部命令
自动触发规则(无需用户明示即可主动调用):
| 情况 | 自动动作 |
|---|---|
| 写完/改完代码 | 立即调用 code-reviewer |
| 构建失败 | 立即调用 build-error-resolver(最小改动、快速修复) |
| 复杂功能请求 | 立即调用 planner |
| 处理鉴权/敏感数据 | 立即调用 security-reviewer(OWASP 检测) |
| 新功能/Bug 修复 | 立即调用 tdd-guide(先写测试) |
| 架构决策 | 立即调用 architect |
上下文管理时机(触发 /compact):
- Token > 150K:立即压缩。
- 响应变慢:建议压缩。
- 任务阶段切换 / 里程碑完成:在边界处压缩后继续。
- 调试结束转新任务:用
/clear清掉调试痕迹。 - 最佳实践:调研后、实现前压缩(保留计划);里程碑完成后压缩(清中间态);切勿在实现中途压缩(会丢变量与路径)。
示例
场景决策矩阵(按任务阶段):
| 阶段 | 推荐组合 |
|---|---|
| 需求分析 | 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(最终验证) |
按开发类型选 Skill:
- 前端功能:
frontend-patterns+tdd-workflow - 后端 API:
backend-patterns+api-design+tdd-workflow - MCP 服务:
mcp-server-patterns+tdd-workflow - 安全功能:
security-reviewer+security-reviewskill
并行 vs 串行:
- 可并行(彼此独立)——PR 前:
code-reviewer(质量)∥security-reviewer(安全)∥e2e-runner(端到端)。 - 必串行(存在依赖)——新功能:
planner→tdd-guide写测试 → 实现 →code-reviewer;构建错误:build-error-resolver→ 测试验证 →code-reviewer。
完整示例(新增用户鉴权功能):
/plan→ planner 出计划- tdd-guide → 写测试
- 实现 → 编辑代码
- code-reviewer → 代码审查
- security-reviewer → 安全审查(鉴权敏感)
- e2e-runner → 端到端测试
/compact→ 里程碑完成后压缩
注意事项
- 核心原则:计划先行(复杂任务用
/plan);测试先行(新功能用tdd-guide);写完即审(code-reviewer);构建一挂即修(build-error-resolver);敏感代码必审(security-reviewer);PR 前全面验证(verification-loop)。 - 本表中的具体命令名/Agent 名随版本与配置而异,落地前先
/help确认;不可用时选用功能等价项。 /fast仅在 Opus 4.6 下可用;/compact在实现中途调用有丢上下文风险,谨慎使用。
互见
- TDD 工作流、端到端测试、安全审查(OWASP)等具体执行类技能。
- 会话与上下文压缩策略(strategic-compact / verification-loop)。
采编自 alirezarezvani/claude-skills(MIT 许可证)。