> ## Documentation Index > Fetch the complete documentation index at: https://factory-docs-model-update-cl-824.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # スキル > AIエージェントが必要に応じて呼び出す再利用可能な機能。 スキルは**再利用可能な機能**で、Droidができることを拡張します。指示を書いた`SKILL.md`ファイルを作成すると、Droidがそれをツールキットに追加します。Droidは関連する場合にスキルを使用するか、`/skill-name`で直接呼び出すこともできます。 例については[スキルガイド](/jp/guides/skills/frontend-ui-integration)をご覧ください。 **カスタムスラッシュコマンドはスキルに統合されました。** `.factory/commands/review.md`のファイルと`.factory/skills/review/SKILL.md`のスキルは、どちらも`/review`を作成し、同じように動作します。既存の`.factory/commands/`ファイルは引き続き機能します。スキルには追加機能があります：サポートファイル用のディレクトリ、[誰が呼び出せるかを制御する](#control-who-invokes-a-skill)フロントマター、そしてDroidが関連する場合に自動的にロードする機能です。 **主要な特性：** * **柔軟な呼び出し** – あなたとDroidの両方がスキルを呼び出せます。`/skill-name`と入力するか、Droidがいつ使用するかを決めるかです。 * **組み合わせ可能** – より大きなワークフローの一部として連携できます * **トークン効率的** – 軽量で集中的、未使用のツールや重複した指示で肥大化していません **スキルには以下があります：** * **ワークフロー** – 段階的な指示（例：「URLにナビゲート、スクリーンショット撮影、データ抽出」） * **専門知識** – ドメイン知識と慣例（例：「デザインシステムを使ったフロントエンド機能の実装方法」） * **両方** – 指示 + ツール + ベストプラクティスをまとめたもの **スキルの例：** * `browser` – CDPツールでChromeを自動化（ナビゲート、スクリーンショット、JS評価） * `linear` – CLIツールでLinearの問題を管理（リスト、ステータス更新、チーム移動） * `frontend-ui-integration` – チームの慣例に従って型付きReactフローを実装 ## スキルとは何ですか？ スキルは**ディレクトリ**（例：`.factory/skills/frontend-ui-integration/`）で、以下を含みます： * YAMLフロントマターとmarkdown指示を含む`SKILL.md`または`skill.mdx` * オプションのサポートファイル（スクリプト、スキーマ、チェックリスト） 各スキルは解決する問題、期待する入力、成功の定義を定義します。Droidは現在のタスクに適用される場合、マッチするスキルを自動的に呼び出します。 ## スキルファイル形式 スキルはYAMLフロントマター付きのMarkdownで定義されます。小さく集中したスキルは、短い`SKILL.md`だけでも構いません： ```md theme={null} --- name: summarize-diff description: Summarize the staged git diff in 3–5 bullets. Use when the user asks for a summary of pending changes. --- # Summarize Diff ## Instructions 1. Run `git diff --staged`. 2. Summarize the changes in 3–5 bullets, focusing on user-visible behavior. 3. Call out any migrations, risky areas, or tests that should be run. ``` 追加のフロントマター項目を含めて動作を制御することもできます。利用可能なすべてのオプションについては、[フロントマターリファレンス](#frontmatter-reference)をご覧ください。 ## スキルが存在する場所 スキルは、よく知られた少数の場所から検出されます： | スコープ | 場所 | 目的 | | ----------- | ------------------------- | -------------------------------- | | **ワークスペース** | `/.factory/skills/` | チームメイトと共有するプロジェクトスキル；gitにチェックイン。 | | **個人** | `~/.factory/skills/` | マシン上のプロジェクト間で共有される個人スキル。 | | **互換性** | `/.agent/skills/` | `.agent`フォルダ規約との互換性のために検出。 | 各**スキル**は、これらのルートのいずれかの下で独自のディレクトリに存在します： * ワークスペース: `/.factory/skills//SKILL.md` * 個人: `~/.factory/skills//SKILL.md` 大規模なモノレポでは、以下のいずれかを選択できます： * ルートに**単一の共有**スキルフォルダを保持： ```text theme={null} .factory/skills/ frontend/ SKILL.md payments-service/ SKILL.md data-warehouse-querying/ SKILL.md ``` * または**プロジェクトごとに**`.factory`フォルダを追加して、スキルを各サブプロジェクトと一緒に配置します： ```text theme={null} services/payments/.factory/skills/ payments-service/ SKILL.md apps/frontend/.factory/skills/ dashboard-ui/ SKILL.md ``` プロジェクトスキルは、エンジニアリング組織内で機能を共有・標準化するための主要な方法です。個人スキルは、個人のワークフローや実験に最適です。 ## フロントマターリファレンス スキルは、`SKILL.md` ファイルの先頭にある `---` マーカー間でYAMLフロントマターフィールドをサポートします： ```yaml theme={null} --- name: my-skill description: What this skill does and when to use it user-invocable: true disable-model-invocation: false --- Your skill instructions here... ``` | フィールド | 必須 | デフォルト | 説明 | | :------------------------- | :-- | :------ | :---------------------------------------------------------------------- | | `name` | いいえ | ディレクトリ名 | スキルの表示名。小文字、数字、ハイフンのみ使用可能。 | | `description` | 推奨 | — | スキルが何をするか、いつ使用するかの説明。Droidはこれを使ってスキルを適用するタイミングを決定する。 | | `user-invocable` | いいえ | `true` | `/`スラッシュコマンドメニューから隠すには`false`に設定。ユーザーが直接呼び出すべきでないバックグラウンド知識に使用。 | | `disable-model-invocation` | いいえ | `false` | Droidがこのスキルを自動的にロードするのを防ぐには`true`に設定。`/skill-name`で手動でトリガーしたいワークフローに使用。 | ## スキルを呼び出すユーザーの制御 デフォルトでは、あなたもDroidも任意のスキルを呼び出すことができます。`/skill-name`と入力して直接呼び出すことができ、Droidは会話に関連する場合に自動的にロードできます。2つのフロントマターフィールドでこれを制限できます： * **`disable-model-invocation: true`**: あなただけがスキルを呼び出せます。副作用があるワークフローや、`/deploy`や`/send-notification`のようにタイミングを制御したいワークフローに使用します。コードが準備できているように見えるからといってDroidがデプロイを決定するのは望ましくありません。 * **`user-invocable: false`**: Droidのみがスキルを呼び出せます。コマンドとして実行可能でないバックグラウンド知識に使用します。`legacy-system-context`スキルは古いシステムの動作を説明します。Droidは関連する場合にこれを知っているべきですが、`/legacy-system-context`はユーザーが実行する意味のあるアクションではありません。 ### 呼び出しの概要 | フロントマター | ユーザーが`/invoke`可能 | Droidが呼び出し可能 | | :------------------------------- | :--------------- | :----------- | | （デフォルト） | はい | はい | | `disable-model-invocation: true` | はい | いいえ | | `user-invocable: false` | いいえ | はい | ## クイックスタート リポジトリ内で、`.factory/skills/`にディレクトリを作成します。例： `.factory/skills/frontend-ui-integration/` フォルダ内に、YAMLフロントマター（`name`、`description`）と 機能、入力、成功基準を定義するマークダウン指示を含む `SKILL.md`または`skill.mdx`を作成します。 スキルがアクティブな時にDroidが使用すべき型、スキーマ、 またはチェックリストを同じ場所に配置します（例：`types.ts`、 `schemas/`、または`rollout-checklist.md`）。 `droid`またはインテグレーションを再起動してスキルを再スキャンし、 通常どおりタスクを説明します。Droidは適用可能な場合に マッチングスキルを自動的に呼び出します。 ## スキルと他の設定の違い スキルは、Droidの動作を形成する他の方法と併存します： * **カスタムドロイド** – *どの*モデルとツールを使用し、どのレベルの自律性で使用するかを定義；完全なエージェント設定です。 * **レガシースラッシュコマンド**（`.factory/commands/`） – ユーザーが呼び出すマクロで、まだ動作しますが現在はスキルに置き換えられています。スキルは同じ`/command`機能に加え、オプションのDroid呼び出しとサポートファイルを提供します。 * **MCPサーバー** – 外部システム（API、データベース、SaaSツール）をツールとして公開；リソースの*接続*に関するもので、ワークフローのエンコードではありません。 スキルが異なるのは以下の理由です： * **作業の実行方法**（エンジニアリングプレイブック）を再利用可能な機能としてパッケージ化。 * **柔軟な呼び出し**をサポート – あなた（`/skill-name`経由）とDroidの両方がトリガーでき、[誰が何を呼び出せるかの細かい制御](#control-who-invokes-a-skill)が可能。 * **発見可能で組み合わせ可能** – Droidは計画内で複数のスキルを連鎖できる。 * ツール、カスタムドロイド、MCPサーバーの上に位置して、それらを安全にオーケストレーション可能。 実際には以下のようになります： * MCPを使用して内部デプロイメントAPIを公開。 * カスタムドロイドを使用してCI内で許可されるツール/モデルを定義。 * スキルを使用して「カナリアデプロイメントを安全にロールアウトする方法」をそのAPIとドロイド設定を使ってエンコード。 ## エンタープライズコードベースでスキルが重要な理由 スキルは、以下が必要なエンタープライズ環境で特に価値があります： * Droidが**フロントエンド実装、サービス統合、データクエリ、内部ツール**をどのように実行するかを標準化。 * **チーム規約、安全ルール、SLA**を一度エンコードし、プロジェクト間で再利用。 * 自動化を「一つのチャットで起こったこと」ではなく、gitを介して**発見可能、監査可能、共有可能**にする。 Factoryのためにスキルをゼロから作成したり、他のエージェント用にすでに投資した既存のスキルを再利用して、ドロイド設定にインポートして配線したりできます。 # ベストプラクティス **単一責任**を中心にスキルを設計する（例：「既存エンドポイント用の型付きReact UIを実装」）、「機能全体を構築」ではなく。 **明確な成功基準**を定義：スキルが完了時にどのような成果物が存在すべきか（変更されたファイル、追加されたテスト、更新されたドキュメント、収集された承認）。 一つの巨大な「すべてを実行」スキルよりも、Droidが組み合わせるいくつかの小さなスキルを優先。 必要な入力を文書化：リポジトリパス、関係するサービス、API、スキーマ、機能フラグ名など。 APIやデータモデルを説明する際は、長い散文の代わりに**構造化フィールド**（JSONスニペット、箇条書き、表）を使用。 セキュリティに敏感なワークフローについては、明示的な\*\*「決して実行しない」\*\*制約とエスカレーション条件を含める。 **テスト、観測可能性、ロールアウト要件**を組み込んで、スキルが常にそれらに従うようにする。 すべてをインライン化する代わりに、既存の**AGENTS.md**、ランブック、設計ドキュメントを参照。 ドメインに応じて**証明成果物**を要求：テスト、スクリーンショット、ログクエリ、またはダッシュボードへのリンク。 **大きなmonorepo、複数のサービス、階層化された承認**を想定。 Droidが触れる可能性のある**ディレクトリ**、境界内の言語/フレームワーク、そうでないものを明示。 **チーム間依存関係**のガイダンスを含める – いつスタブするか、いつ他のチームと調整するか、いつ停止して質問するか。 **冪等**スキルを優先：同じブランチ/PRで再実行しても安全。 可能な限り**機械解析可能な出力**を生成するスキルを設計（例：他のスキルが使用できる短い要約ブロック）。 現在のブランチを超えて**ステートレス**なスキルを維持：以前の実行についての隠れた仮定なし。 Droidがスキルを完了する前に実行しなければならないコマンドをリストした\*\*「検証」**セクションを常に含める。 検証が失敗した場合の**フォールバック**を明記（ロールバック手順、機能フラグ、またはカナリアパス）。 本番環境に近いスキルについては、Droidが**PRを開くが人間のレビューなしにマージしない\*\*ことを要求。 ## クックブック クックブックは、一般的なエンタープライズソフトウェアワークフローを対象とした独断的なスキルテンプレートを提供します。 9つのスキルファミリーに焦点を当てています： 1. **[フロントエンド実装スキル](/jp/guides/skills/frontend-ui-integration)** – 既存のAPIと統合するUIサーフェスの構築 2. **[複雑なコードベース用統合スキル](/jp/guides/skills/service-integration)** – 大きなmonorepo内でのサービス拡張や配線 3. **[内部データクエリスキル](/jp/guides/skills/data-querying)** – 内部分析やデータサービスへの安全で監査可能なアクセス 4. **[内部ツールスキル](/jp/guides/skills/internal-tools)** – 開発者とオペレーターのワークフローを改善する小さくて堅牢な内部アプリの構築 5. **[バイブコーディングスキル](/jp/guides/skills/vibe-coding)** – 完全なモダンWebアプリケーションをゼロから迅速にプロトタイピングし構築（Lovable/Bolt/v0の代替） 6. **[AIデータアナリストスキル](/jp/guides/skills/ai-data-analyst)** – 包括的なデータ分析、視覚化、統計モデリング（データアナリストツールの代替） 7. **[プロダクトマネジメントスキル](/jp/guides/skills/product-management)** – PRD、機能分析、PMワークフローの支援（PMツールの拡張） 8. **[ブラウザ自動化スキル](/jp/guides/skills/browser)** – CDP経由でChromeを起動し、ライブタブをナビゲートし、DOM状態を評価し、MCPサーバーを実行せずにスクリーンショットやセレクターを収集 9. **[自動化QAスキル](/jp/guides/skills/automated-qa)** – 実際のユーザーと同様にアプリケーションをテストするエンドツーエンドの品質保証、視覚的証拠、CI統合、失敗学習付き 既存のバックエンドAPIに対して、デザインシステム、ルーティング、テスト規約を使用して、型安全でテスト済みのフロントエンドフローを実装します。 所有権の境界、可観測性、ロールアウト要件を尊重しながら、共有モノレポでバックエンドサービスを拡張または配線します。 内部分析およびデータサービスを安全にクエリし、再現可能なクエリと共有可能な分析成果物を生成します。 強力なRBAC、監査ログ、運用上の安全措置を備えた内部向けツール（管理パネル、コンソール、ユーティリティ）を構築または拡張します。 React、Next.js、Vue、またはその他のフレームワークを使用して、完全なモダンWebアプリケーションを迅速にプロトタイプ化し、ゼロから構築します。Lovable、Bolt、v0のローカルファースト代替手段。 Pythonと完全なデータサイエンスエコシステムを使用して、包括的なデータ分析、統計モデリングを実行し、出版品質の可視化を作成します。 PRD作成、機能分析、調査の統合、ロードマッププランニングを含むプロダクト管理ワークフローを支援します。 追加のインフラを展開せずに、リモートデバッグでChromeを起動し、タブを駆動し、DOM状態を評価し、スクリーンショットやセレクタを取得します。 実際のユーザーと同様にアプリをテストするエンドツーエンド品質保証 -- Web、CLI、APIサーフェス全体で -- 視覚的証拠とCI統合を提供します。 実際には、各スキルフォルダには、エージェントがコアプロンプトテンプレートと併用する可能性のある**サポートユーティリティ**も含めることができます - 例： * `SKILL.md`または`skill.mdx` – メインのスキル仕様 * `references.md` – あなたのコードベースに既存する型、API、モジュールへのリンクと参照 * `schemas/` – スキルによって参照されるJSON/YAMLスキーマまたはOpenAPIスニペット（信頼できる情報源のサービスコードではない） * `checklists.md` – 再利用可能な検証またはロールアウトチェックリスト これらの併設ファイルにより、プロダクションコードを複製または移転することなく、スキルが呼び出された際にエージェントが作業できる予測可能で構造化されたコンテキストバンドルを提供します。 これらを出発点として使用し、入力、制約、検証ステップをあなたのスタックとガバナンス要件に合わせて適応させてください。