カスタムDroid（サブエージェント）

​

1 · カスタムdroids とは？

• プロジェクトdroids は <repo>/.factory/droids/ に配置され、チームメンバーと共有されます。
• 個人droids は ~/.factory/droids/ に保存され、ワークスペース間で引き継がれます。
• 名前が一致する場合、プロジェクト定義が個人定義を上書きします。

​

2 · なぜ使うのか？

• 高速な委任 – 複雑なチェックリストを一度エンコードし、単一のツール呼び出しで再利用。
• 厳格な安全性 – エージェントを読み取り専用、編集専用、または厳選されたツールセットに制限。
• コンテキスト分離 – 各サブエージェントは新しいコンテキストウィンドウで実行され、プロンプトの肥大化を回避。
• 再現可能なレビュー – チーム固有のレビュー、テスト、またはリリースゲートをバージョン管理可能なコードとして取得。

​

3 · クイックスタート

1. /droids を実行してDroids メニューを起動します。
2. Create a new Droid を選択し、保存場所（プロジェクトまたは個人）を選んで、ウィザードに従って以下を設定します：
   • droid が実行すべきことの説明
   • システムプロンプト（自動生成または手動編集）
   • 識別子（droid の名前）
   • モデル（または親セッションから継承）
   • ツール（ツールIDの明示的なリストまたはカテゴリ）
3. 保存します。CLI は選択した droids/ ディレクトリに <name>.md を書き込み、ファイル名を正規化します（小文字、ハイフン区切り）。
4. droid に使用を依頼します。例：「サブエージェント code-reviewer でTask ツールを実行してこのdiffをレビューして」、または自動化からトリガーします。

​

4 · 設定

---
name: code-reviewer
description: Focused reviewer that checks diffs for correctness risks
model: inherit
tools: read-only
---

You are the team's senior reviewer. Examine the diff the parent agent shares and:

- flag correctness, security, and migration risks
- list targeted follow-up tasks if changes are required
- confirm tests or manual validation needed before merge

Respond with:
Summary: <one-line finding>
Findings:

- <bullet>
- <bullet>

---
name: deep-analyzer
description: Thorough analysis with extended thinking
model: claude-sonnet-4-5-20250929
reasoningEffort: high
tools: ["Read", "Grep", "Glob", "WebSearch"]
---

Perform deep analysis of the code or problem presented...

​

ツールカテゴリ → 具体的なツール

​

5 · UI でのdroids 管理

• droids のリスト – 各droid を以下の情報と共に表示：
  • 名前とモデル（括弧内）
  • 説明のプレビュー
  • 場所バッジ（Project / Personal）
  • ツールの概要（例：「All tools」または選択されたツールの数）
• Create a new Droid – ガイド付きウィザードを起動：
  1. 場所を選択（Project または Personal）
  2. droid が実行すべきことを説明
  3. システムプロンプトを生成または手動編集
  4. 識別子、モデル、ツールを確認
• Import from Claude Code – ~/.claude/agents/ の既存エージェントをカスタムdroids としてインポート
• アクション – droids の表示、編集、削除、またはリロードしてリストを更新

​

5.5 · Claude Code サブエージェントのインポート

​

インポート方法

1. /droids を実行してDroids メニューを開きます
2. I を押してインポートフローを開始します
3. CLI がClaude Code エージェントディレクトリをスキャンします：
   • プロジェクトスコープ：<repo>/.claude/agents/（ワークスペース固有のエージェント）
   • 個人スコープ：~/.claude/agents/（個人エージェント）
4. 利用可能なエージェントのリストを確認します：
   • (already exists) とマークされたエージェントはデフォルトで非選択状態
   • 事前選択されたエージェントは、まだDroids にインポートされていないもの
5. Space で個別選択を切り替え、A ですべてを切り替えます
6. Enter を押して選択されたエージェントをインポートします

​

インポート中に実行される処理

1. メタデータの抽出：
   • エージェント名 → droid name
   • エージェント説明（例と使用ガイダンスを含む）→ droid description
   • エージェント指示 → droid システムプロンプト（本文）
2. 設定のマッピング：
   • モデル：Claude Code モデルファミリーをFactory モデルにマッピング：
     • inherit → inherit
     • sonnet → 利用可能な最初のSonnet モデル
     • haiku → 利用可能な最初のHaiku モデル
     • opus → 利用可能な最初のOpus モデル
   • ツール：Claude Code ツール名をFactory ツールにマッピング（ツールがマッピングされない場合は検証警告を表示）
   • 場所：デフォルトで Personal ~/.factory/droids/ にインポート
3. ツール検証：
   • 一部のClaude Code ツールはFactory に相当するものがない場合があります
   • 無効なツールは警告と共にリスト表示されます：「Invalid tools: [list]」
   • droid を編集してツールマッピングを修正するか、ツールアクセスを調整できます
4. ファイル作成：
   • ~/.factory/droids/（個人場所）に .md ファイルを作成
   • ファイル名は正規化されます（小文字、ハイフン区切り）
   • ファイル形式：YAML frontmatter + システムプロンプト本文
5. インポートレポート：
   • 各エージェントの成功/失敗を表示
   • インポートされたエージェントはすぐにdroid リストで利用可能
   • インポートされたdroid を編集してモデル、ツール、プロンプトを調整可能

​

インポートフローの例

Import Droids (.claude/agents)

Project (<repo>/.claude/agents/):
> [x] polite-greeter
  Use this agent when the user requests a greeting, says hello, or asks for a polite
  welcome message. Examples: <example>...

  [ ] code-summarizer
  Use this agent when you need to understand what a code file does without diving into
  implementation details. Examples: <example>...

Personal (~/.claude/agents/):
  [x] security-checker
  Security analysis agent...

↑/↓ navigate • Space select • A toggle all • Enter import • B back

Custom Droids

> code-reviewer (gpt-5-codex)
  This droid verifies the correct base branch and committed...
  Location: Project  •  Tools: All tools

  polite-greeter (claude-opus-4-5-20251101)
  Use this agent when the user requests a greeting, says he...
  Location: Personal  •  Tools: 1 selected

  code-summarizer (claude-sonnet-4-5-20250929)
  Use this agent when you need to understand what a code fi...
  Location: Personal  •  Tools: All tools

​

ツール検証エラーの処理

1. droid を表示（Enter を押す）して完全なツールリストを確認
2. droid を編集（E を押す）して調整：
   • リストから無効なツールを削除
   • 有効なFactory ツールのみを保持
3. 利用可能なツールを確認 - リストに利用可能なFactory ツールが表示されます

• Write、NotebookEdit、BrowseURL などのClaude Code ツールはFactory には存在しません
• 相当するFactory ツールに置き換え：
  • Write → Edit、Create
  • BrowseURL → WebSearch、FetchUrl
• または tools セクション全体を削除してすべてのFactory ツールを有効化

​

6 · カスタムdroids の効果的な使用

• Task ツール経由で呼び出し – droid は自動的にカスタムdroids を呼び出すか、直接リクエストできます（「この変更にサブエージェント security-auditor を使って」）。
• モデルを戦略的に選択 – inherit を使用して親セッションとマッチさせるか、専門タスクに異なるモデルを指定：
  • 単純な分析と要約タスクには小さい/高速なモデル（低コスト）。
  • 複雑な推論、コードレビュー、多段階分析には大きい/高性能なモデル。
  • 利用可能なモデルIDについては pricing page を参照してください。
• ツールアクセスを制限 – 明示的なツールリストを使用してサブエージェントができることを制限し、予期しないシェルコマンドや他の危険な操作を防止。
• ライブ更新を活用 – Task ツールはライブ進行状況をストリーミングし、サブエージェントの実行中にツール呼び出し、結果、TodoWrite 更新をリアルタイムで表示。
• 出力を構造化 – Summary: や Findings: などのセクションを出力するようプロンプトを整理し、Task ツールUI が結果を明確に要約できるようにします。
• 共有と協力 – チームメンバーが共有droids を使用できるよう .factory/droids/*.md をリポジトリにチェックインし、プロンプトの更新をコードのようにバージョン管理。
• Claude Code エージェントを活用 – 既存のClaude Code エージェント（セクション5.5を参照）をインポートして、Factory でカスタムdroids として再利用。

​

7 · 例

​

コードレビュワー（プロジェクトスコープ）

---
name: code-reviewer
description: Reviews diffs for correctness, tests, and migration fallout
model: inherit
tools: ["Read", "LS", "Grep", "Glob"]
---

You are the team's principal reviewer. Given the diff and context:

- Summarize the intent of the change.
- Flag correctness risks, missing tests, or rollback hazards.
- Call out any migrations or data changes that need coordination.

Reply with:
Summary: <one-line>
Findings:

- <issue or ✅ No blockers>
  Follow-up:
- <action or leave blank>

​

セキュリティスイーパー（個人スコープ）

---
name: security-sweeper
description: Looks for insecure patterns in recently edited files
model: inherit
tools: ["Read", "Grep", "WebSearch"]
---

Investigate the files referenced in the prompt for security issues:

- Identify injection, insecure transport, privilege escalation, or secrets exposure.
- Suggest concrete mitigations.
- Link to relevant CWE or internal standards when helpful.

Respond with:
Summary: <headline>
Findings:

- <file>: <issue>
  Mitigations:
- <recommendation>

​

タスクコーディネーター（ライブ進行状況付き）

---
name: task-coordinator
description: Coordinates multi-step tasks with live progress updates
model: inherit
tools: ["Read", "Edit", "Execute"]
---

You are a task coordinator. Break down the goal into actionable steps:

1. Use TodoWrite to create and update a task list
2. For each task, read relevant files and execute commands as needed
3. Report progress in real-time using TodoWrite updates

Keep the task list updated with completion status (pending, in_progress, completed).