command-creator

Command Creator

このスキルは、Claude Code のスラッシュコマンドの作成をガイドします。スラッシュコマンドは、Claude Code の会話内で /command-name によって呼び出せる再利用可能なワークフローです。

スラッシュコマンードについて

スラッシュコマンドは、.claude/commands/（プロジェクトレベル）または ~/.claude/commands/（グローバル／ユーザーレベル）に保存された Markdown ファイルで、呼び出されるとプロンプトに展開されます。次のような用途に適しています。

• 繰り返し行うワークフロー（コードレビュー、PR の提出、CI の修正など）
• 一貫性が求められる複数ステップのプロセス
• エージェントへの委任パターン
• プロジェクト固有の自動化

このスキルを使うタイミング

ユーザーが次のように依頼したときにこのスキルを呼び出します。

• 「コマンドを作成して」または「スラッシュコマンドを作って」と頼まれたとき
• 繰り返しのワークフローを自動化したいとき
• 再利用できるように一貫したプロセスを文書化する必要があるとき
• 「いつも X をしているので、そのためのコマンドを作れますか？」と言われたとき
• プロジェクト固有またはグローバルなコマンドを作成したいとき

同梱リソース

このスキルには、詳細なガイダンスのためのリファレンスドキュメントが含まれています。

• references/patterns.md - コマンドパターン（ワークフロー自動化、反復的な修正、エージェント委任、単純な実行）
• references/examples.md - 完全なソースを含む実際のコマンド例（submit-stack、ensure-ci、create-implementation-plan）
• references/best-practices.md - 品質チェックリスト、よくある落とし穴、記述ガイドライン、テンプレート構造

コマンドを作成する際は、パターンを理解したり、例を確認したり、品質を確保したりするために、必要に応じてこれらのリファレンスを読み込んでください。

コマンド構造の概要

すべてのスラッシュコマンドは、次の要素を持つ Markdown ファイルです。

---
description: Brief description shown in /help (required)
argument-hint: <placeholder> (optional, if command takes arguments)
---

# Command Title

[Detailed instructions for the agent to execute autonomously]

コマンド作成ワークフロー

ステップ 1: 保存場所の決定

適切な場所を自動検出します。

1. Git リポジトリの状態を確認します: git rev-parse --is-inside-work-tree 2>/dev/null
2. デフォルトの場所:
   • Git リポジトリ内の場合 → プロジェクトレベル: .claude/commands/
   • Git リポジトリ外の場合 → グローバル: ~/.claude/commands/
3. ユーザーによる上書きを許可します:
   • ユーザーが「global」または「user-level」と明示的に指定した場合 → ~/.claude/commands/ を使用
   • ユーザーが「project」または「project-level」と明示的に指定した場合 → .claude/commands/ を使用

先に進む前に、選択した場所をユーザーに報告してください。

ステップ 2: コマンドパターンの提示

ユーザーが各コマンドの種類を理解できるように支援します。references/patterns.md を読み込み、利用可能なパターンを確認します。

• ワークフロー自動化 - 分析 → 実行 → 報告（例: submit-stack）
• 反復的な修正 - 実行 → 解析 → 修正 → 繰り返し（例: ensure-ci）
• エージェント委任 - コンテキスト → 委任 → 反復（例: create-implementation-plan）
• 単純な実行 - 引数付きでコマンドを実行（例: codex-review）

ユーザーに「どのパターンが作成したいものに最も近いですか？」と尋ねます。これにより会話の方向性が定まります。

ステップ 3: コマンド情報の収集

ユーザーに主要な情報を尋ねます。

A. コマンド名と目的

次のように尋ねます。

• 「コマンドの名前は何にしますか？」（ファイル名用）
• 「このコマンドは何をしますか？」（description フィールド用）

ガイドライン:

• コマンド名は必ず kebab-case にしてください（ハイフンを使用し、アンダースコアは使用しない）
  • ✅ 正しい: submit-stack, ensure-ci, create-from-plan
  • ❌ 誤り: submit_stack, ensure_ci, create_from_plan
• ファイル名はコマンド名と一致させます: my-command.md → /my-command として呼び出される
• description は簡潔で、動作を示す内容にしてください（/help の出力に表示されます）

B. 引数

次のように尋ねます。

• 「このコマンドは引数を受け取りますか？」
• 「引数は必須ですか、それとも任意ですか？」
• 「引数は何を表すべきですか？」

コマンドが引数を受け取る場合:

• フロントマターに argument-hint: <placeholder> を追加します
• 必須の引数には <angle-brackets> を使用します
• 任意の引数には [square-brackets] を使用します

C. ワークフローの手順

次のように尋ねます。

• 「このコマンドが従うべき具体的な手順は何ですか？」
• 「それらはどの順序で実行されるべきですか？」
• 「どのツールやコマンドを使用すべきですか？」

次の点について詳細を収集します。

• 実行すべき初期分析やチェック
• 主要な実行内容
• 結果の扱い方
• 成功の基準
• エラー処理の方法

D. ツールの制限とガイダンス

次のことを確認します:

• 「このコマンドでは特定のエージェントやツールを使用すべきですか?」
• 「避けるべきツールや操作はありますか?」
• 「コンテキストとして読み込むべき特定のファイルはありますか?」

ステップ 4: 最適化されたコマンドを生成する

エージェント向けに最適化された指示を含むコマンドファイルを作成します。以下の内容については references/best-practices.md を読み込んでください:

• テンプレートの構造
• エージェント実行のためのベストプラクティス
• 文章作成のガイドライン
• 品質チェックリスト

主な原則:

• 命令形/不定詞形を使用する(動詞で始まる指示)
• 明示的かつ具体的にする
• 期待される結果を含める
• 具体的な例を示す
• 明確なエラー処理を定義する

ステップ 5: コマンドファイルを作成する

1. 完全なファイルパスを決定します:

   • プロジェクト: .claude/commands/[command-name].md
   • グローバル: ~/.claude/commands/[command-name].md

2. ディレクトリが存在することを確認します:

   mkdir -p [directory-path]
   

3. Write ツールを使用してコマンドファイルを書き込みます

4. ユーザーに確認します:

   • ファイルの場所を報告する
   • コマンドの動作を要約する
   • 使い方を説明する: /command-name [arguments]

ステップ 6: テストと反復(任意)

ユーザーがテストしたい場合:

1. テストを提案します: 次のコマンドを実行してこのコマンドをテストできます: /command-name [arguments]
2. フィードバックに基づいて反復する準備をします
3. 必要に応じて、改善内容をファイルに反映します

クイックヒント

詳細なガイダンスについては、同梱のリファレンスを読み込んでください:

• コマンドのワークフローを設計するときは references/patterns.md を読み込む
• 既存のコマンドの構造を確認するには references/examples.md を読み込む
• 仕上げる前に品質を確認するため references/best-practices.md を読み込む

覚えておくとよい一般的なパターン:

• pytest、pyright、ruff、prettier、make、gt などのコマンドには Bash ツールを使用する
• 専門的なタスクにはTask ツールを使用してサブエージェントを呼び出す
• 処理を進める前に、特定のファイル(例: .PLAN.md)の有無を確認する
• ToDo は一括ではなく、完了したらすぐにマークする
• 明示的なエラー処理の指示を含める
• 明確な成功基準を定義する

まとめ

コマンドを作成する際の流れ:

1. 配置場所を判断する(プロジェクトかグローバルか)
2. パターンを示して会話の枠組みを整える
3. 情報を収集する(名前、目的、引数、手順、ツール)
4. エージェントが実行可能な指示を含む最適化されたコマンドを生成する
5. 適切な場所にファイルを作成する
6. 確認し、必要に応じて反復する

エージェントが自律的に実行できるコマンドの作成に注力してください。明確な手順、明示的なツールの使用、適切なエラー処理を備えたコマンドを目指します。