カスタムスラッシュコマンドは、繰り返し可能なプロンプトやセットアップ手順を/shortcutsに変換します。Droidは.factory/commandsフォルダのペアをスキャンし、各ファイルをコマンドに変換して、結果を会話またはターミナルセッションに直接パイプします。
スキルはスラッシュコマンドとしてユーザーから呼び出せるようになりました。 .factory/skills/に、スラッシュコマンド(ユーザー起動)としてもDroidが呼び出せる機能としても動作するスキルを作成できます。既存の.factory/commands/ファイルはそのまま動作します。新しいコマンドでは、補助ファイルや呼び出し制御などの追加機能を備えたスキルの使用を検討してください。
1 · 検出と命名
- Markdown(
*.md)ファイルと先頭にshebang(#!)があるファイルのみが登録されます。
- ファイル名はスラッグ化されます(小文字、スペース →
-、URL安全でない文字は削除)。Code Review.mdxは/code-reviewになります。
- チャットから
/command-name optional argumentsでコマンドを呼び出します。スラッシュ候補はファイルから取得した説明を使用します。
/commandsを実行して、コマンドの閲覧、リロード(R)、またはインポート用のカスタムコマンドマネージャーUIを開きます。
- コマンドは
commandsディレクトリのトップレベルに配置する必要があります。ネストしたフォルダは現在無視されます。
2 · Markdownコマンド
Markdownファイルは、droidの次のターンをシードするシステム通知にレンダリングされます。オプションのYAMLフロントマターがオートコンプリートメタデータを制御します。
$ARGUMENTSはコマンド名の後に入力されたすべてに展開されます。$ARGUMENTSを参照しない場合、本文は変更されずに送信されます。
Markdown出力はシステム通知にラップされるため、次のエージェントターンで
すぐにプロンプトを確認できます。
$1や$2のような位置プレースホルダーはまだサポートされていません。
構造化入力が必要な場合は$ARGUMENTSを使用し、プロンプト内で解析してください。
3 · 実行可能コマンド
実行可能ファイルは、CLIがインタープリターを呼び出せるように、有効なshebangで始まる必要があります。
- 実行可能ファイルはコマンド引数を受け取ります(
/deploy feature/login → $1=feature/login)。
- スクリプトは現在の作業ディレクトリから実行され、あなたの環境を継承するため、あなたと同じ権限を持ちます。
- 標準出力と標準エラー出力(最大64 KB)およびスクリプトの内容は、透明性のためにチャットトランスクリプトに投稿されます。失敗してもログは表示されます。
4 · コマンドの管理
- 編集または追加:
.factory/commandsでファイルを直接編集します。CLIは起動時に再スキャンします。再起動せずにリロードするには、/commands内でRを押してください。
- インポート:既存の
.agentsまたは.claudeコマンドをインポートします:/commandsを開き、Iを押し、エントリを選択すると、Factoryディレクトリにコピーされます。
- 削除:ファイルを削除してコマンドを削除します。ワークスペースコマンドが優先されるため、リポジトリバージョンを削除すると、存在する場合は個人のフォールバックが表示されます。
5 · 使用パターン
- チームメイトが同じショートカットを共有できるように、リポジトリの
.factory/commands内でプロジェクトワークフローをバージョン管理下に置きます。
- 再実行しても安全な冪等スクリプトを作成し、クリーンアップ手順はファイル自体に文書化します。
- チェックリスト、コードレビューのルーブリック、オンボーディング指示、またはdroidに頻繁に提供するコンテキストパケット用にMarkdownテンプレートを使用します。
- 実行可能コマンドを他のソースコードと同様にレビューし、秘密情報は慎重に扱い、すでにシェルにロードされている環境変数を参照することを推奨します。
6 · 例
コードレビューのルーブリック(Markdown)
/review feature/login-flowで呼び出して、diffを検査する前にdroidに一貫したチェックリストをシードします。
日次スタンドアップヘルパー(Markdown)
gitヒストリーやTODOリストをdroidがレビューした後に/standupを使用して、洗練されたアップデートを生成します。
リグレッションスモークテスト(実行可能)
smoke.shとして保存すると、/smokeとして表示されます。パス(/smoke src/widgets/__tests__/widget.test.tsx)を渡してチェックを制限し、集約された出力をスレッドの全員と共有します。
一度セットアップすると、カスタムスラッシュコマンドは複数ステップのプロンプトや環境セットアップを単一のキーストロークに圧縮し、定型文を繰り返すのではなくdroidのガイドに集中できるようになります。