tool-command-creator

Tool / Cursor Slash-Command Creator

slash-command は Agent が実行する再利用可能な手順書である。 入力・出力・関連資源・手順の分岐を本文で明示し、後続 Agent が迷わず実行できるようにする。

いつ使うか / 使わないか

• 使う: .cursor/commands/ に配置する Cursor slash-command の作成・改訂
• 使わない: Agent Skill（.cursor/skills/**/SKILL.md）の作成（skill-creator 等）
• 使わない: 一度きりの会話プロンプトの下書きだけ（ファイルとして残さない場合）

出力先と命名

• プロジェクト共有: .cursor/commands/{command-name}.md
• APM パッケージのソース: .apm/prompts/{command-name}.prompt.md（install 後に .cursor/commands/ 等へ展開される）
• ファイル名がコマンド名になる（例: docs.render.md → /docs.render）
• このリポジトリでは {領域}.{動詞や目的} のドット区切りを推奨する（例: docs.format-plan, git.preflight）
• 本文 H1 はファイル名ではなく、内容要約のタイトル（例: 実装フロー / 要件定義）にする

共有アセット

コマンド本文に長い書式・テンプレート・複数コマンドで共有する資料を埋め込まない。 ファイル参照は ## 関連ファイル、探索ディレクトリは ## アセットディレクトリ に分ける。

リポジトリ直下のコマンド（未パッケージ）

• 配置: .cursor/extra/{領域またはコマンド名}/...
  • 領域共有の例: .cursor/extra/docs/requirements.md
• コマンドからの参照は相対パス（例: [requirements.md](../extra/docs/requirements.md)）
• {assets}/ を使う場合は ## アセットディレクトリ に候補ディレクトリを列挙する

APM パッケージ内のコマンド

• ソース配置: .apm/assets/{領域またはコマンド名}/...
  • 例: .apm/assets/example.command/template.md
• 本文・## 関連ファイル ではインストール先の 1 パスを直書きせず、{assets}/... メタ変数を使う
  • 例: {assets}/template.md
• {assets}/ を使う場合は、本文の ## アセットディレクトリ に実ディレクトリ候補を列挙する（正本）
  • ソース相対（開発時）: ../assets/example.command/
  • install 後ルート相対: apm_modules/**/agent-creator/.apm/assets/example.command/
• 旧来の metadata.assets だけがある文書も workspace-resolve-agent-assets は読めるが、新規・改訂では本文セクションへ書く
• 実行時の実体解決は workspace-resolve-agent-assets に従う（文書相対とワークスペースルート相対の両方を試し、ヒットを示す）

コマンド単体に閉じる短い例示だけなら本文に書いてよい。書式の正本・長いテンプレート・共有ルールはアセットへ寄せる。

必須: テンプレート準拠

出力は必ず assets/command.md に従う。 プレースホルダ（{...}）と HTML コメントは最終成果物から除去する。

生成コマンドの実行契約（必須）

作成・改訂する slash-command 自体が、実行時に次を守るように書く。

非対話

• ユーザーへの確認質問・選択肢提示・追加情報の依頼を行わない
• 不足情報を対話で補完せず、文脈・引数・既存ファイルから確定できる範囲だけを使う

不明確はエラー終了（実行時）

次のいずれかが明確にならない場合は、処理を続けずエラーとして終了する。

• 入力（Required の欠落、解釈不能、矛盾）
• 出力（保存先・形式・成功条件が特定できない）

手順の不明確は実行時エラーにしない。 生成コマンドの最終出力（手順・ガードレール・フローチャート）に「手順が不明確です」等の分岐を書かない。