PaPoo
cover

よく使う頼みごとをスラッシュコマンド(カスタムコマンド)にする

毎回同じお願いをベタ打ちしているなら、そこがいちばんムダだ。Claude Code は「よく使う頼みごと」をスラッシュコマンドに落としておくと、指示の抜け漏れが減るし、毎回の入力もかなり軽くなる。

たとえば「このフォルダをざっと整理して」「この文章を読みやすく直して」「この差分を短く要約して」といった定番の頼み方は、手で打つほど雑になりやすい。急いでいると条件を書き忘れるし、長い依頼文はコピペのたびに少しずつ崩れる。そうなると、Claude Code 側は毎回あいまいな指示を受けて、手戻りが増える。筆者も最初はここでだいぶ損をした。頼みごとをそのまま繰り返していたせいで、出力の粒度が毎回ぶれて、結局もう一回やり直す羽目になった。

スラッシュコマンドは、その定番依頼を短い呼び出し名にまとめるやり方だ。Claude Code ではカスタムスラッシュコマンドをファイルとして置いておける。公式の扱いに沿って使うなら、まずは CLAUDE.md のような指示ファイルに毎回の前提を書き、個別の頼みごとはスラッシュコマンド化しておく、という分け方がしっくりくる。

たとえば、ドキュメントを毎回この形で整えたいとする。

- 要点を先に出す
- 冗長な表現を削る
- 箇条書きは必要なところだけ残す
- 事実関係が怪しい表現は断る

この手の指示を毎回打つのはしんどい。なら、専用コマンドにしてしまえばいい。Claude Code のカスタムコマンドは、プロジェクト単位で置く方法と、個人用に置く方法を使い分けるのが実用的だ。細かい置き場所や読み込み仕様は、使っている版の公式ドキュメントで確認してほしいが、考え方は単純で、再利用したい指示をファイルにして名前を付けるだけだ。

運用の感覚としては、こういう形がわかりやすい。

/doc-cleanup
このフォルダ内の文書を、次の方針で整えてください。
- 先頭に要点を置く
- 重複表現を削る
- 専門用語は必要最小限にする
- ただし意味は変えない
- 変更点があれば最後に短く説明する

呼び出す側は、毎回この長文を打たなくていい。短い名前を指定して起動し、必要に応じて対象ファイルや追加条件を足す。これだけで、頼み方のばらつきがかなり減る。

非エンジニアの使い方でも、この恩恵は大きい。たとえば書類整理なら、「請求書フォルダから重複っぽいファイル名を拾う」「ファイル名の命名規則をそろえる」「古い下書き候補を洗い出す」といった繰り返し作業を定型化できる。毎回「今回は何をどこまでやらせるか」を説明するのは面倒だが、カスタムコマンドにしておけば、いつもの頼み方を一発で出せる。弁護士事務所や総務のように、案件ごとにフォルダが増える仕事ではかなり効く。人がやるのは判断、繰り返しの説明は Claude Code に寄せる、という分担にできる。

実際に作るときは、コマンドの中身を「短い命令の束」にするのがコツだ。長い説明文を詰め込みすぎると、逆に使いにくい。筆者は最初、あれもこれも入れたくなって、注意書きだらけのコマンドを作った。だがそれは読まれない。毎回同じ注意を読むのがだるいから、結局使わなくなる。スラッシュコマンドは、説明書ではなく、手を動かすための型だ。長文にするより、迷わず使える短さを優先したほうがいい。

もうひとつ大事なのは、コマンドに「やること」と「やらないこと」を両方入れることだ。たとえば文書校正なら、ただ「読みやすくして」では弱い。こんなふうに絞る。

/shorten-report
次の条件で本文を短くしてください。
- 意味は変えない
- 箇条書きに逃げず、必要なら段落で直す
- 固有名詞は勝手に変えない
- 不明な事実は補完しない
- 直した理由を最後に3点以内で書く

これで、勝手な意訳や盛り込みを抑えやすくなる。Claude Code は文脈に忠実なほど強いが、指示がふわっとしていると、ふわっとした出力が返ってくる。そこをスラッシュコマンドで締めるわけだ。

注意したいのは、スラッシュコマンドに何でも詰め込まないことだ。全部を一つにまとめると、結局メンテしづらくなる。たとえば「整理」「要約」「命名変更」「削除候補の洗い出し」を一つの巨大コマンドに入れると、場面ごとに不要な処理まで混ざる。筆者はこれで一度やらかした。ディスク整理のつもりで走らせたら、要約向けの指示まで混じって、返答が無駄に長くなった。便利どころか、毎回の確認が増えてしまった。用途が違うなら、コマンドも分けるべきだ。

もうひとつ、コマンド名は短く、意味がぶれないものにする。/cleanup みたいに広すぎる名前は危ない。文書用なのか、ファイル整理用なのか、あとで見てもわからなくなる。/doc-cleanup/file-triage/summarize-diff のように、何をするかが一目でわかる名前のほうがいい。短い名前は楽だが、曖昧さはあとで回収が面倒になる。

実務では、まず「週に何度も繰り返す頼みごと」から作るのが正解だ。毎回の入力時間が削れ、指示の品質もそろう。次に、長い依頼文をそのままコピーするのではなく、よく使う部分だけをコマンド化する。必要なら CLAUDE.md 側に「このプロジェクトではこういう文体で返す」「このフォルダは触ってよい」などの前提を寄せる。そうすると、スラッシュコマンドは短く保てる。

要するに、スラッシュコマンドは「Claude Code に毎回説明していた手間」を、再利用できる型に変える道具だ。雑な長文を毎回打つより、よく使う依頼を一回きれいに作って、二度目以降を軽くする。これだけで作業の疲れ方がかなり変わる。

細かい構文や保存場所は、Claude Code の公式ドキュメントで確認しながら作るのが安全だ。仕様をうろ覚えで触ると、探し直しの時間が地味にかさむ。まずは「自分が今月いちばん繰り返しているお願い」を一つ選ぶ。そこからでいい。

関連 TIPS

同じ著者の記事