メインコンテンツへスキップ
カスタムスラッシュコマンドは、繰り返し可能なプロンプトやセットアップ手順を/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: Send a code review checklist
argument-hint: <branch-name>
---

Please review `$ARGUMENTS` and summarize any merge blockers, test gaps, and risky areas.

- Highlight security or performance concerns
- Suggest follow-up tasks with owners
- List files that need attention
フロントマターキー目的
descriptionスラッシュ候補に表示される生成された要約をオーバーライドします。
argument-hintインライン使用法ヒントを追加します(例:/code-review <branch-name>)。
allowed-tools将来の使用のために予約されています。省略しても安全です。
$ARGUMENTSはコマンド名の後に入力されたすべてに展開されます。$ARGUMENTSを参照しない場合、本文は変更されずに送信されます。
Markdown output is wrapped in a system notification so the next agent turn immediately sees the prompt.
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で始まる必要があります。
#!/usr/bin/env bash
set -euo pipefail

echo "Preparing $1"
npm install
npm run lint
echo "Ready to deploy $1"
  • 実行可能ファイルはコマンド引数を受け取ります(/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)

---
description: Ask droid for a structured code review
argument-hint: <branch-or-PR>
---

Review `$ARGUMENTS` and respond with:

1. **Summary** – What changed and why it matters.
2. **Correctness** – Tests, edge cases, and regressions to check.
3. **Risks** – Security, performance, or migration concerns.
4. **Follow-up** – Concrete TODOs for the author.

Include file paths alongside any specific feedback.
/review feature/login-flowで呼び出して、diffを検査する前にdroidに一貫したチェックリストをシードします。

日次スタンドアップヘルパー(Markdown)

---
description: Summarize progress for standup
---

Draft a standup update using:

- **Yesterday:** Key wins, merged PRs, or blockers cleared.
- **Today:** Planned work items and their goals.
- **Risks:** Anything at risk of slipping, support needed, or cross-team dependencies.

Keep it to three short bullet sections.
gitヒストリーやTODOリストをdroidがレビューした後に/standupを使用して、洗練されたアップデートを生成します。

リグレッションスモークテスト(実行可能)

#!/usr/bin/env bash
set -euo pipefail

target=${1:-"src"}

echo "Running lint + unit tests for $target"
npm run lint -- "$target"
npm test -- --runTestsByPath "$target"

echo "Collecting git status"
git status --short

echo "Done"
smoke.shとして保存すると、/smokeとして表示されます。パス(/smoke src/widgets/__tests__/widget.test.tsx)を渡してチェックを制限し、集約された出力をスレッドの全員と共有します。 一度セットアップすると、カスタムスラッシュコマンドは複数ステップのプロンプトや環境セットアップを単一のキーストロークに圧縮し、定型文を繰り返すのではなくdroidのガイドに集中できるようになります。