CockpitCockpit
← 返回博客

Claude Code 斜杠模式实战:/qa、/fx、/review、/commit

发布于 2026年4月29日 · 阅读约 5 分钟

一个被低估的提效技巧:与其每次都写一遍"做 X 但不要动代码",不如一次性把它保存为斜杠指令。Cockpit 内置 4 个 —— 这篇讲每个适合什么场景。

我读过的每个高效率 Claude Code 对话里都有同一个模式:用户上来先告诉 Agent 什么 不要 做。

"现在先别改代码,把这个 bug 给我讲一遍。"

"别重构,只评 diff。"

"别先写功能,先把需求复述一遍给我听。"

这些不是任务,是姿态。它们把 Agent 从"默认写代码"切换到"做某种特定类型的协作者"。姿态对了,实际对话就短得多、快得多。

斜杠指令就是把这些姿态保存成快捷方式。Cockpit 内置了 4 个 —— 跟 Anthropic 的 ~/.claude/commands/ 机制完全一样,只是预装好了。

/qa —— 只澄清,绝不写代码

经典的"先聊清楚,绝不动代码"模式。

/qa 我要给用户账号加软删除。

Agent 会:

  • 用自己的话复述需求。
  • 对每一个模糊点反问(级联删除?保留期?UI 上能恢复吗?)。
  • 遵循 KISS —— 你只问一个问题,它不会甩你三个架构。
  • 在你点头之前不会写代码。

适合:开新需求、推方案、上手陌生仓库。

/fx —— 只诊断,绝不改文件

Bug 证据链模式。

/fx /api/users 接口偶发返回 500,没有日志。

Agent 会:

  • 端到端读一遍失败路径。
  • 建一条证据链:哪个文件、哪个假设、哪个观察到的现象。
  • 不会动一个文件。
  • 最后给出一个具体的可证伪假设。

这就是"AI 修了一个东西又搞坏了两个"和"AI 告诉我哪里真坏了,我自己修对了"之间的区别。Bug 面陌生、或修错代价高的时候用 /fx

/review —— 读 diff,写评审,不动手

PR 前自检。

/review

(不用传参,它自己取当前 diff)

Agent 会:

  • git diff 和周边文件作为上下文。
  • 像资深工程师一样逐行写评审:取舍、缺失的测试、边界、"为什么不这么做?"。
  • 不会动你的代码。

小技巧:把这些评审意见喂给一轮新的 /qa,自己决定哪些采纳。多一双眼睛,但这双眼睛没有自尊心。

/commit —— 按你仓库的风格提交

最不性感、最常用的一个。

/commit

Agent 会:

  • 读最近 20 条 commit message 学你的风格(Conventional?祈使句?带 emoji?)。
  • stage 正确的文件(跳过 lockfile、生成目录)。
  • 按你的风格起草 message。
  • commit。

每次省 10 秒,但你每天要提 30 次。

做你自己的

把任意 markdown 丢进 ~/.claude/commands/(或者仓库本地 ./.claude/commands/),它就成了斜杠指令。文件正文 就是 system prompt。一些意外好用的例子:

  • /security —— "只评安全问题,不要风格 / 性能评论。CVE 类的先列。"
  • /migrate —— "我在把这个文件从 X 迁到 Y。不要改行为。不要重排。只给 diff。"
  • /why —— "解释这段代码 为什么 存在。看 git blame、周围测试、上下 10 行内的 TODO/FIXME。"

Cockpit 会自动把你放进去的任意文件加到斜杠补全菜单。

背后的原则

默认 Claude Code 是行动偏向 —— 写代码、保存文件、交付。这是 60% 时候的好默认值,另外 40% 的烂默认值。斜杠模式是你 有意识 切换默认值的方式。

如果你一周里超过两次写同样的"别做 X"前言,那就是一个等着诞生的斜杠指令。


npm i -g @surething/cockpit · GitHub · 在线体验