/shortcutsに変換します。Droidは.factory/commandsフォルダのペアをスキャンし、各ファイルをコマンドに変換して、結果を会話またはターミナルセッションに直接パイプします。
Skills are now user-invokable via slash commands. You can create skills in
.factory/skills/ that work as both slash commands (user-invoked) and Droid-invocable capabilities. Your existing .factory/commands/ files continue to work unchanged. For new commands, consider using skills instead – they offer additional features like supporting files and invocation control.1 · 検出と命名
| スコープ | 場所 | 目的 |
|---|---|---|
| ワークスペース | <repo>/.factory/commands | チームメイトと共有するプロジェクト固有のコマンド。同じスラッグを持つ個人コマンドをオーバーライドします。 |
| 個人 | ~/.factory/commands | 常にスキャンされます。プライベートまたはクロスプロジェクトのショートカットを保存します。 |
- Markdown(
*.md)ファイルと先頭にshebang(#!)があるファイルのみが登録されます。 - ファイル名はスラッグ化されます(小文字、スペース →
-、URL安全でない文字は削除)。Code Review.mdxは/code-reviewになります。 - チャットから
/command-name optional argumentsでコマンドを呼び出します。スラッシュ候補はファイルから取得した説明を使用します。 /commandsを実行して、コマンドの閲覧、リロード(R)、またはインポート用のカスタムコマンドマネージャーUIを開きます。- コマンドは
commandsディレクトリのトップレベルに配置する必要があります。ネストしたフォルダは現在無視されます。
2 · Markdownコマンド
Markdownファイルは、droidの次のターンをシードするシステム通知にレンダリングされます。オプションのYAMLフロントマターがオートコンプリートメタデータを制御します。| フロントマターキー | 目的 |
|---|---|
description | スラッシュ候補に表示される生成された要約をオーバーライドします。 |
argument-hint | インライン使用法ヒントを追加します(例:/code-review <branch-name>)。 |
allowed-tools | 将来の使用のために予約されています。省略しても安全です。 |
$ARGUMENTSはコマンド名の後に入力されたすべてに展開されます。$ARGUMENTSを参照しない場合、本文は変更されずに送信されます。
Positional placeholders like
$1 or $2 are not supported yet—use
$ARGUMENTS and parse inside the prompt if you need structured input.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)
/standupを使用して、洗練されたアップデートを生成します。
リグレッションスモークテスト(実行可能)
smoke.shとして保存すると、/smokeとして表示されます。パス(/smoke src/widgets/__tests__/widget.test.tsx)を渡してチェックを制限し、集約された出力をスレッドの全員と共有します。
一度セットアップすると、カスタムスラッシュコマンドは複数ステップのプロンプトや環境セットアップを単一のキーストロークに圧縮し、定型文を繰り返すのではなくdroidのガイドに集中できるようになります。