From 021526b433811e04c0c8be5f8946bf50d65b8ba5 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 8 Jul 2026 21:46:28 +0000 Subject: [PATCH] docs: sync and translate English doc changes to Japanese --- docs/jp/changelog/release-notes.mdx | 411 ++++++++++++++++++ docs/jp/cli/account/droid-shield.mdx | 37 +- docs/jp/cli/byok/lm-studio.mdx | 72 +++ docs/jp/cli/configuration/mcp.mdx | 65 ++- docs/jp/cli/configuration/settings.mdx | 18 + docs/jp/cli/features/droid-control.mdx | 18 +- docs/jp/cli/features/missions/running-cli.mdx | 2 +- .../cli/user-guides/choosing-your-model.mdx | 28 +- .../enterprise/enterprise-plugin-registry.mdx | 29 ++ .../hierarchical-settings-and-org-control.mdx | 8 +- .../llm-safety-and-agent-controls.mdx | 1 + docs/jp/enterprise/service-accounts.mdx | 2 +- docs/jp/features/missions/overview.mdx | 2 +- docs/jp/features/missions/planning.mdx | 5 +- docs/jp/features/missions/reference.mdx | 2 +- docs/jp/features/missions/troubleshooting.mdx | 22 +- docs/jp/guides/building/building-plugins.mdx | 175 +++++++- docs/jp/guides/droid-exec/code-review.mdx | 45 ++ docs/jp/integrations/slack.mdx | 103 ++++- docs/jp/reference/hooks-reference.mdx | 2 +- docs/jp/web/automations.mdx | 115 +++++ docs/jp/web/factory-router.mdx | 10 +- docs/jp/web/missions.mdx | 10 +- docs/jp/web/software-factory.mdx | 88 ++++ 24 files changed, 1188 insertions(+), 82 deletions(-) create mode 100644 docs/jp/cli/byok/lm-studio.mdx create mode 100644 docs/jp/web/automations.mdx create mode 100644 docs/jp/web/software-factory.mdx diff --git a/docs/jp/changelog/release-notes.mdx b/docs/jp/changelog/release-notes.mdx index 9015748a4..7ee97d061 100644 --- a/docs/jp/changelog/release-notes.mdx +++ b/docs/jp/changelog/release-notes.mdx @@ -4,6 +4,399 @@ description: Factory App、Droid CLI、その他のプロダクトサーフェ rss: true --- + + `v0.167.0` + +## 新機能 + +- **Droid Computerのポート転送** - `droid computer port-forward`コマンドを追加し、Droid Computerのポートをローカルマシンに転送できるようになりました + +## 改善 + +- **app起動の高速化** - 起動時のブートフェーズが並列実行されるようになり、使用可能なウィンドウが表示されるまでの時間を短縮しました（app） +- **セッション検索の高速化** - セッション検索が高速化され、より適切に順位付けされた結果を返すようになりました +- **フルスクリーンのヘルプ** - ヘルプがフルスクリーンのオーバーレイで開くようになり、`?`または`Esc`で閉じられるようになりました +- **スラッシュメニューのフィルタリング** - フィルタリング後のスラッシュメニュー結果が、より分かりやすいカテゴリーブロックにフラット化されました +- **モデル名の表示改善** - app全体でモデル名がより見やすく表示されるようになりました（app） +- **チャットトランスクリプトの整理** - 内部ツールの検索結果がチャットトランスクリプトを煩雑にしなくなりました（app） +- **アップデートのロールバック** - 必要に応じて、appを以前のバージョンへロールバックできるようになりました（app） + +## バグ修正 + +- **Windowsでの画像貼り付け** - WindowsでComposerに画像を貼り付けられない問題を修正しました +- **アップデート中の安全な終了** - バックグラウンド更新の進行中でも安全に終了できるようになりました +- **SessionStartフック** - ハングした`SessionStart`フックがセッション初期化を妨げないようになりました +- **完了音** - 完了音を復元しました +- **Windowsのホームディレクトリ** - 非ASCIIのWindowsユーザー名でホームディレクトリ解決に失敗する問題を修正しました +- **下書きの添付ファイル** - 画面再描画時にも下書きの添付ファイルが保持されるようになりました +- **サンドボックス化されたフック** - サンドボックス下でのフックコマンド実行を修正しました +- **詳細トランスクリプトのフリーズ** - 詳細トランスクリプトのツール結果に上限を設け、`Ctrl+O`でフリーズしないようにしました +- **新規セッションのショートカット** - 新規セッションのショートカットがShiftを無視するようになりました（app） +- **切り詰められたセッション** - 切り詰められたセッションでのコンテキスト処理を修正しました +- **Linuxクリップボード** - LinuxでテキストクリップボードがWayland優先になりました +- **特殊文字** - `å`、`Å`、`´`の入力がOptionショートカットとして扱われなくなりました +- **利用できないツール** - 利用できないツールへの呼び出しが、エラーとして明確に表示されるようになりました +- **ハイライトされたコード** - ハイライトされたコードテキストが保持されるようになりました（app） +- **Airgapモード** - Airgapモードの信頼性を改善しました（app） + + + + + `v0.164.0` + +## 新機能 + +- **グループ化されたスラッシュコマンド** - スラッシュコマンドがカテゴリごとに整理され、より見つけやすくなりました +- **クラウド同期の制御** - データをクラウドに同期するかどうかを制御する新しい設定を追加しました（app） + +## 改善 + +- **Linearのモデルピッカー** - Linearの委譲ピッカーでモデル名がすっきり表示されるようになりました（app） +- **Droid Computerプロビジョニングウィザード** - Droid Computerのプロビジョニングウィザード内の文言をより分かりやすくしました（app） + +## バグ修正 + +- **MCPツール名** - MCP仕様に従い、ドットを含むツール名を受け付けるようになりました +- **MCP認証** - 一部のOAuthクライアント登録を拒否するMCPサーバーでサインインできるように戻しました +- **droid execでのバックグラウンドプロセス** - エージェントが起動したバックグラウンドプロセスが、`droid exec`の終了後も実行され続けるようになりました +- **許可/拒否リスト用エディター** - ヘッドレスホストで許可リストと拒否リストを編集する際に、CLIが`$EDITOR`を尊重するようになりました +- **Geminiの推論** - 無効なGeminiの推論ブロックの処理を修正しました +- **Droid Computer SSH** - Droid Computerに完全一致の名前で接続できない問題を修正しました +- **組織をまたぐログイン** - 複数の組織をまたいで作業する際のログイン問題を修正しました（app） + + + + + `v0.162.0` + +## 新機能 + +- **プロジェクト内のクローン済みリポジトリ** - クローンしたリポジトリが、新規セッションのプロジェクトドロップダウンに表示されるようになりました（app） + +## 改善 + +- **メモリ使用量の削減** - 長時間のセッション中やアイドル中のメモリ使用量を削減しました +- **単語単位の移動** - 補助的なテキスト入力欄で、Option+Left/Rightにより単語単位で移動できるようになりました + +## バグ修正 + +- **再開後のフック** - セッション再開後にフック行が正しくレンダリングされるようになりました +- **ファイルエンコーディング** - 編集したファイルが常にUTF-8で保存されるのではなく、元のエンコーディングを保持するようになりました +- **MCP認証** - OAuth経由でMCPサーバーにサインインする際、basic authへのフォールバックを復元しました +- **組織の切り替え** - EUを含め、組織切り替え時にアクティブな組織が正しく選択されるようになりました（app） + + + + + `v0.161.0` + +## 新機能 + +- **フックマネージャーの刷新** - フックの表示と設定を行うフックマネージャーを再設計しました +- **WezTermセットアップ** - WezTerm向けのターミナルセットアップサポートを追加しました +- **チャットトランスクリプト検索** - チャットトランスクリプト内を検索できるようになりました（app） + +## 改善 + +- **検索の高速化** - 不要な検索キャッシュの再構築を回避するようになりました + + + + + `v0.159.0` + +## 新機能 + +- **プロジェクトのアーカイブ** - 作業しなくなったプロジェクトをアーカイブして、プロジェクト一覧を整理できるようになりました（app） + +## 改善 + +- **より分かりやすいMCP認証ガイダンス** - MCPサーバーの認証に失敗した場合に、CLIが解決方法を案内するようになりました + +## バグ修正 + +- **MCP設定エラー** - MCP設定のパースエラーが、黙って失敗するのではなく明確に表示されるようになりました + + + + + `v0.158.0` + +## 新機能 + +- **プラグインの有効化と無効化** - 新しいトグルで個々のプラグインをオンまたはオフにできるようになりました + +## 改善 + +- **Tabでスラッシュコマンドを補完** - Tabキーでスラッシュコマンドを補完できるようになりました +- **MCP認証** - MCP認証レスポンスとDesktopリダイレクトの処理を改善しました +- **アカウントクレジットでのチェックアウト** - アカウントクレジットを使ってプランの新規契約やアップグレードができるようになりました + +## バグ修正 + +- **無効なAPIキーでのログイン** - 無効な`FACTORY_API_KEY`が指定されている場合、CLIがログインで停止せずエラーで終了するようになりました +- **AskUserプロンプトのキャンセル** - AskUserプロンプトをキャンセルすると、エージェントが続行せず中断されるようになりました +- **重複するツール承認** - 承認が必要なツール実行が一度だけ表示されるようになりました +- **Windowsのバックグラウンドプロセス** - Windowsで終了時にバックグラウンドプロセスが正しくクリーンアップされるようになりました +- **Documentスキルの保存場所** - Documentスキルが現在の作業ディレクトリに書き込まれるようになりました +- **ダークモードのトグル** - ダークモードのトグルが表示され、ローディングスピナーも正しくアニメーションするようになりました（app） +- **編集可能なComposer** - セッションがブロックされている間もComposerを編集できるようになりました（app） + + + + + `v0.157.2` + +## バグ修正 + +- **Slackフォローアッププロンプト** - Slackスレッドで重複して表示されることがあった「tag to follow up」プロンプトを修正しました + + + + + `v0.157.0` + +## 新機能 + +- **プロンプトの外部編集** - 長いメッセージを作成するために、外部エディターでプロンプトを開いて編集できるようになりました + +## バグ修正 + +- **Caps Lock時のカーソルキー** - Caps Lockがオンのときのカーソルキー処理を修正しました +- **オンボーディング時のクラッシュ** - オンボーディングが完了する前に接続した場合に発生する可能性があったクラッシュを修正しました（app） + + + + + `v0.156.2` + +## 新機能 + +- **会話の巻き戻し** - 新しい`/rewind-conversation`コマンドでチャットを巻き戻し、ファイルを以前の時点の状態に戻せるようになりました（app） +- **組織のフックガバナンス** - 組織がメンバー全体のフック設定を一元的に管理できるようになりました + +## 改善 + +- **クリック可能なメッセージリンク** - メッセージ内のURLをクリックできるようになりました +- **ライトターミナルの色** - ライトターミナルテーマでの白色の表示を改善しました + +## バグ修正 + +- **推論インジケーター** - thinkingを行わないモデルで推論インジケーターが表示されなくなりました +- **Executeステップのシマー** - 完了済みのExecuteステップに古いローディングシマーが残る問題を修正しました +- **Windowsのフック** - Windows上のフックでコマンドのクォートが保持されるようになりました +- **MCPサーバーロゴ** - MCPサーバーロゴが元の色を保持するようになりました + + + + + `v0.152.0` + +## 新機能 + +- **自律性フラグ** - `droid --auto high`でDroidの自律性レベルをコマンドラインから直接設定できるようになりました +- **組織のMCPとマーケットプレイス制御** - 組織がMCPサーバーとプラグインマーケットプレイスへのアクセスを一元的に管理できるようになりました +- **app内のメンバー管理** - app内で組織メンバーを直接管理できるようになりました（app） + +## 改善 + +- **プライベートnpmレジストリのプラグイン** - プラグインソースが、認証トークンの環境変数を使ってプライベートnpmレジストリに認証できるようになりました +- **オンボーディング文言** - Droidセットアップのオンボーディング時の案内をより分かりやすくしました（app） + +## バグ修正 + +- **中断後のステータス** - 中断後にDroidのステータスが正しくクリアされるようになりました +- **イベントフック** - 同じイベントに設定された複数のフックが正しく結合されるようになりました +- **ディレクトリをまたぐ要約** - 作業ディレクトリが変わったときの会話要約を修正しました +- **ストリーミングプレースホルダー** - チャットに古いプレースホルダーが残る問題を修正しました（app） +- **接続の安定性** - 短時間の接続切断時にセッションUIがちらつく問題を軽減しました（app） + + + + + `v0.151.0` + +## 新機能 + +- **エディターでのスキルスラッシュコマンド** - 外部エディターから接続したときにも、スキルのスラッシュコマンドを利用できるようになりました + +## 改善 + +- **macOSインストーラーのブランド表示** - macOS DMGインストーラーがブランド付きになりました（app） +- **MarkdownとしてのMCP結果** - JSONで返されたMCPツール結果が整形されたMarkdownとして表示されるようになりました + +## バグ修正 + +- **セッションの再接続** - Session Unavailableページにリダイレクトされる代わりに、セッションが表示されたまま再接続されるようになりました（app） +- **組織スイッチャー** - Desktopの組織スイッチャーに現在選択中の組織が表示されるようになりました（app） +- **Desktop MCPサインイン** - DesktopのMCP認証コールバック処理を改善しました（app） +- **Composerアクションのレイアウト** - Composerのアクションが1行に収まるようになりました（app） + + + + + `v0.150.0` + +## 新機能 + +- **npmプラグインソース** - プラグインマーケットプレイスの定義から、npmパッケージとして公開されたプラグインを参照できるようになりました +- **終了確認** - アクティブなDroidセッションを中断する可能性がある場合、Desktopで終了やウィンドウを閉じる前に確認を求めるようになりました（app） + +## 改善 + +- **長時間セッションのパフォーマンス** - 長時間のセッションでチャットのパフォーマンスを改善しました（app） +- **MCP認証ページ** - MCP認証成功ページを改善しました +- **期限超過請求書バナー** - 請求設定で請求書の支払い期限を過ぎている場合にバナーが表示されるようになりました（app） + +## バグ修正 + +- **Rate Limitリセット表示** - 1時間未満でリセットされる場合のRate Limitリセット時刻表示を修正しました + + + + + `v0.149.0` + +## バグ修正 + +- **Canva MCP認証** - Canva MCPサーバーへの接続がより確実に動作するよう、フォールバックを追加しました + + + + + `v0.148.0` + +## 新機能 + +- **MCP接続ステータス** - `droid mcp list`とセッションで、各MCPサーバーの接続状態と認証状態が表示されるようになりました +- **組織全体での自動更新制御** - 新しい`disableAutoUpdate`設定で、組織がCLIの自動更新を無効にできるようになりました + +## 改善 + +- **ログローテーション** - CLIがログファイルをローテーションし、ディスク容量を使い切らないようになりました +- **エディターでのMCP読み込み高速化** - 外部エディターから接続したときに、MCPサーバーがブロックせずに読み込まれるようになりました +- **Desktopでのサインアップの簡素化** - Desktopでのサインアップ後、直接ログインに進むようになりました（app） +- **未保存の変更バナーの視認性向上** - 未保存の変更バナーが見つけやすくなりました（app） + +## バグ修正 + +- **重複するBYOKモデル** - BYOKモデルセレクターから重複するモデルを削除しました +- **BYOKカスタムエンドポイント** - カスタムBYOKモデルエンドポイントとの互換性を修正しました +- **重複するトランスクリプト** - セッションビューに重複したトランスクリプトが表示される問題を修正しました +- **`/plugins`スラッシュコマンド** - セッションの初期化が完了する前でも`/plugins`コマンドが表示されるようになりました（app） +- **Wiki Readerのドラッグ** - Wiki Readerでウィンドウを再びドラッグできるようになりました（app） +- **MCP認証通知** - MCP認証プロンプトの表示方法を改善しました + + + + + `v0.147.0` + +## 新機能 + +- **コマンドのブロックリスト** - 新しい`commandBlocklist`設定により、指定したコマンドをハードストップできるようになり、完全自律時や承認をスキップした場合でも決して実行されなくなりました +- **ウェルカム画面でのサインイン** - ウェルカム画面にログインとサインアップのコールトゥアクションを追加しました（app） + +## 改善 + +- **MCP OAuth** - MCPサーバーがClient ID Metadata Documents（CIMD）を使って認証できるようになり、resource indicatorを必要とするサーバーとの互換性も向上しました +- **ツールチップの更新** - より分かりやすい案内になるよう、ツールチップを更新しました + +## バグ修正 + +- **Ctrl+Enterツールチップ** - Ctrl+Enterのツールチップを修正しました +- **Desktop MCP OAuthバナー** - DesktopのMCP OAuthバナーがMCPボタンを指すようになりました（app） + + + + + `v0.146.0` + +## 新機能 + +- **ブラウザーベースのDesktopオンボーディング** - Desktopオンボーディングがブラウザーで開くようになり、初回セットアップがよりスムーズになりました（app） + +## 改善 + +- **メッセージのキューショートカット** - Ctrl+Enterでメッセージをキューできるようになりました +- **より早いセッションタイトル** - Droidが会話のより早い段階でセッション名を付けるようになりました + +## バグ修正 + +- **リサイズ時のチャットカーソル** - ターミナルのリサイズ時にも、チャット入力でカーソル位置が維持されるようになりました +- **コンテキスト要約のハング** - 長い会話の要約中にまれに発生していたハングを修正しました +- **コンテンツフィルタリング** - コンテンツフィルターにブロックされた応答が、明確なモデレーションエラーとして表示されるようになりました +- **Desktop MCP OAuth** - DesktopのMCP OAuthがホストされたコールバック経由で動作するようになりました（app） +- **Desktopオンボーディングのトップバー** - Desktopオンボーディング画面でトップバーをドラッグできるようになりました（app） +- **データ保持ダイアログ** - データ保持ダイアログがDesktopのナビゲーションを妨げなくなりました（app） + + + + + `v0.144.2` + +## バグ修正 + +- **MCP認証** - スコープを公開しないサーバーでも、MCPサインインの信頼性を改善しました +- **Desktop MCP OAuthバナー** - DesktopのMCP OAuthバナーがトップバーに重ならなくなりました（app） + + + + + `v0.144.1` + +## バグ修正 + +- **コンテキスト要約のフォールバック** - モデルが会話の要約を拒否した場合でも、Droidが繰り返し再試行するのではなく、適切にフォールバックするようになりました + + + + + `v0.144.0` + +## 新機能 + +- **セッションファイルの候補表示** - 新規セッションページで開始時に関連ファイルが提案されるようになりました（app） + +## 改善 + +- **より安全なコマンドリスク処理** - 作業ツリーを破壊する可能性があるコマンドが高リスクとして扱われるようになりました +- **tmuxのキーサポート** - tmux内で実行している際のキーボード処理を改善しました + +## バグ修正 + +- **MCPの信頼性** - MCP認証とコネクターの信頼性を改善しました + + + + + `v0.143.1` + +## 改善 + +- **メンテナンスと安定性** - 内部的な定期メンテナンスと信頼性向上を実施しました + + + + + `v0.143.0` + +## 新機能 + +- **セルフサービスでの組織の無効化** - 課金設定でサブスクリプションのキャンセルも行えるようになり、組織を自分で無効化できるようになりました（app） + +## 改善 + +- **より詳細なJira情報** - Jira issueの取得時に、より多くのフィールド、コメント、関連issueのURLが含まれるようになりました +- **出力を抑えたフック** - フックは`suppressOutput`を設定することで、TUIで出力ブロックを非表示にできるようになりました + +## バグ修正 + +- **Windowsのホームディレクトリ** - ユーザー名が壊れないよう、Windowsでのホームディレクトリ解決を修正しました（app） +- **セッション整合性** - 既存のセッションを上書きする可能性があった問題を修正しました + + + `v0.142.0` @@ -109,6 +502,17 @@ rss: true + + `v0.137.0` + +## バグ修正 + +- **重複するthinking出力** - thinking出力が二重にレンダリングされなくなりました +- **MCP権限の永続化** - MCP権限がすべての確認経路で保持されるようになりました +- **コンテキスト使用量メーター** - コンテキスト使用量メーターの配置を修正しました + + + `v0.136.0` @@ -367,6 +771,13 @@ rss: true + + `v0.123.1` + + 内部的な改善を含むメンテナンスリリースです。 + + + `v0.123.0` diff --git a/docs/jp/cli/account/droid-shield.mdx b/docs/jp/cli/account/droid-shield.mdx index 4580e8b1d..4e1511510 100644 --- a/docs/jp/cli/account/droid-shield.mdx +++ b/docs/jp/cli/account/droid-shield.mdx @@ -58,6 +58,29 @@ Droid Shieldは、ランダム性検証を伴うスマートパターンマッ --- +## Droid Shield 2.0: 学習型シークレット検出 + +Droid Shield 2.0 は、パターンベース検出の上に意味的レイヤーを追加する 2 つのファインチューニング済み分類モデルによって、決定論的スキャナーを拡張します。すべての commit と push は引き続き最初に決定論的スキャナーを通過し、その後モデルが、スキャナーがフラグ付けした、または見逃した特定のコンテキストを分類します。 + + + Droid Shield 2.0 はリサーチプレビューです。組織で有効にするには、[お問い合わせください](mailto:support@factory.ai)。 + + +### 2 つの分類モデル + +これらのモデルは決定論的スキャナーの前後で機能し、それぞれ異なる失敗パターンに最適化されています。 + + + + 決定論的スキャナーが**検出しなかった**変更行のうち、周辺コンテキストから見てなおシークレットを含んでいそうな行に対して実行されます。パターンセットが見逃す実際のシークレットを捉えるため、再現率を重視して最適化されています。見逃された可能性のあるシークレットを検出すると、警告を生成します。 + + + スキャナーが**検出した**行に対して実行されます。検出されたシークレットをマスクした周辺コンテキストを確認し、スキャナーのヒットが真陽性（ブロックを維持）か、誤検知（警告にダウングレード）かを判定します。 + + + +--- + ## Droid Shieldが起動するタイミング Droid Shieldは以下のgit操作中に自動的に起動します： @@ -130,6 +153,10 @@ Droid Shieldは慎重を期すために保守的なパターンを使用しま 2. **手動コミットを使用** - Droid以外でgit操作を直接実行 3. **パターンを報告** - 繰り返し発生する誤検出がある場合はsupport@factory.aiまでご連絡ください + + Droid Shield 2.0 が有効な場合、ダウングレードモデルがスキャナーのヒットを自動的に確認し、明らかな誤検知（プレースホルダー、サンプル、テストフィクスチャ）を手動介入なしで除外できます。 + + --- ## ベストプラクティス @@ -165,13 +192,11 @@ Droid Shieldは慎重を期すために保守的なパターンを使用しま ## 制限事項 - **Droid Shieldは検出ツールであり、保証ではありません。** 一般的なシークレットパターンの多くを検出できますが、以下は検出できません: + **Droid Shieldは検出ツールであり、保証ではありません。** 一般的なシークレットパターンの多くを検出できますが、決定論的スキャナー単体では以下を検出できません: - パターンデータベースにないカスタムシークレット形式 - 認識可能なパターンに従わないシークレット - 難読化またはエンコードされた認証情報 - ビジネスロジックの脆弱性やコードセキュリティの問題 - - 常にセキュリティのベストプラクティスに従い、シークレット保護を自動ツールだけに依存しないでください。 --- @@ -185,6 +210,12 @@ Droid Shieldは慎重を期すために保守的なパターンを使用しま Droid Shieldの設定を含むDroid設定を構成します。 + + 学習型分類モデル、トレーニングデータ、評価結果の技術的な詳細を紹介します。 + + + Droid Shieldがより広範なエンタープライズ向けセーフティモデルの中でどのような役割を果たすかを説明します。 + --- diff --git a/docs/jp/cli/byok/lm-studio.mdx b/docs/jp/cli/byok/lm-studio.mdx new file mode 100644 index 000000000..29fe5f073 --- /dev/null +++ b/docs/jp/cli/byok/lm-studio.mdx @@ -0,0 +1,72 @@ +--- +title: "LM Studio" +description: LM StudioでOpenAI互換のローカルモデルを実行する +keywords: ['lm studio', 'local', 'byok', 'openai compatible', 'offline', 'self-hosted'] +--- + +LM StudioのOpenAI互換ローカルサーバーを使って、自分のハードウェア上でモデルをローカル実行します。 + + + **パフォーマンスに関する注意**: 300億パラメータ未満のモデルは、エージェント型コーディングタスクで大幅に低い性能を示しています。小型モデルは実験や学習には役立ちますが、本番のコーディング作業や複雑なソフトウェアエンジニアリングタスクには一般的に推奨されません。 + + +## 設定 + +`~/.factory/settings.json` に追加： + +```json +{ + "customModels": [ + { + "model": "google/gemma-4-e4b", + "displayName": "Gemma 4 E4B [LM Studio]", + "baseUrl": "http://localhost:1234/v1", + "apiKey": "not-needed", + "provider": "openai", + "maxOutputTokens": 16000 + } + ] +} +``` + +`model` は、LM Studioのローカルサーバーに表示される正確なモデル識別子に置き換えてください。 + +## セットアップ + + + **コンテキストウィンドウ設定**: Factoryで最適なパフォーマンスを得るには、サーバーを起動する前にLM Studioでモデルのコンテキストウィンドウを少なくとも32,000トークンに設定してください。十分なコンテキストがない場合、体験は大幅に低下します。 + + +1. [lmstudio.ai](https://lmstudio.ai) からLM Studioをインストール +2. Qwen Coder などのコーディングモデル、または別のOpenAI互換チャットモデルをダウンロード +3. LM Studioで **Developer** タブを開く +4. モデルをロードし、ローカルサーバーを起動 +5. サーバーが `http://localhost:1234/v1` で実行されていることを確認 +6. 上記の設定をFactory設定に追加 + +## モデル ID の確認 + +LM Studioは、OpenAI互換APIを通じてロード済みモデルを公開します： + +```bash +curl http://localhost:1234/v1/models +``` + +返された `id` の値を、Factory設定の `model` として使用してください。 + +## トラブルシューティング + +### ローカルサーバーが接続できない +- LM Studioの **Developer** タブからローカルサーバーが実行中であることを確認 +- サーバーポートが `baseUrl` と一致していることを確認（通常は `1234`） +- 接続テストとして `curl http://localhost:1234/v1/models` を試す + +### モデルが見つからない +- Factoryから使用する前に、LM Studioでモデルをロード +- `curl http://localhost:1234/v1/models` で正確なモデル ID を確認 + +## 注意事項 + +- LM StudioのローカルAPIは認証を必要としないため、`apiKey` には任意のプレースホルダー値を使用できます +- Base URL の形式: `http://localhost:1234/v1` +- LM StudioのOpenAI互換エンドポイントでは `openai` プロバイダーを使用します diff --git a/docs/jp/cli/configuration/mcp.mdx b/docs/jp/cli/configuration/mcp.mdx index e5f81bad5..b1d5dd692 100644 --- a/docs/jp/cli/configuration/mcp.mdx +++ b/docs/jp/cli/configuration/mcp.mdx @@ -301,11 +301,66 @@ OAuthトークンはシステムキーリング（またはフォールバック **http** および **sse** サーバーの場合： - **url**: HTTP/HTTPSエンドポイントURL - **headers**: 認証用HTTPヘッダー（オブジェクト） -- **oauth**: リモートサーバー用の任意の OAuth 上書き設定（オブジェクト）。対応フィールド: - - **scopes**: 要求する OAuth スコープ（配列） - - **clientId**: OAuth クライアント ID - - **clientSecret**: OAuth クライアントシークレット - - **callbackPort**: OAuth コールバックに使用するローカルポート +- **oauth**: このサーバー用の OAuth 上書き設定（オブジェクト）、または OAuth を完全に無効化する `false` + +### OAuth の上書き設定 + +ほとんどのリモートサーバーでは、OAuth は設定不要で動作します。droid が認可サーバーを検出し、Dynamic Client Registration（DCR）でクライアントを自動登録し、サーバーが Client ID Metadata Documents（CIMD）に対応している場合は Factory が公開しているクライアントメタデータを使用します。**まずはこれらのデフォルトを優先してください。** `oauth` の上書き設定は、プロバイダーが独自の信頼ポリシーや互換性ポリシーを必要とする場合にのみ設定してください。 + +**http** または **sse** サーバーの `oauth` オブジェクトでは、以下のフィールドを使用できます。 + +| フィールド | 型 | 説明 | +| :---- | :--- | :---------- | +| `scopes` | `string[]` | 検出されたデフォルトの代わりに要求する OAuth スコープ | +| `authorizationServerIssuer` | `string` | 認可サーバーの issuer URL。`clientId` / `clientSecret` を設定する場合は必須です。 | +| `clientId` | `string` | Dynamic Client Registration をスキップして使う、事前登録済みの OAuth クライアント ID | +| `clientSecret` | `string` | 事前登録済みクライアント用のクライアントシークレット | +| `clientMetadataUrl` | `string` | 公開クライアントのアイデンティティとして使う、カスタム Client ID Metadata Document（CIMD）の HTTPS URL | +| `tokenEndpointAuthMethod` | `"none" \| "client_secret_basic" \| "client_secret_post"` | 検出結果ではなく、トークンエンドポイントの認証方式を強制的に指定します | +| `callbackPort` | `number` | OAuth コールバックに使用する固定の localhost ポート（1〜65535） | + +**制約:** + +- `clientMetadataUrl` は HTTPS URL である必要があり、ルート以外のパスを持ち、認証情報、クエリ文字列、フラグメント、ドットセグメントを含めてはいけません。 +- `clientMetadataUrl` と `clientId` / `clientSecret` は同時に使用できません。メタデータドキュメント自体がクライアントアイデンティティであるため、事前登録済みの認証情報と組み合わせることはできません。 +- `clientMetadataUrl` は公開クライアントを表すため、これを設定する場合、`tokenEndpointAuthMethod` は `"none"` にするか省略する必要があります。 +- `clientId` / `clientSecret` を使う場合は、`authorizationServerIssuer` の設定が必要です。 + +**例: カスタム CIMD ドキュメント** + +CIMD 対応サーバーで、独自にホストしたクライアントメタデータドキュメントを使用する例です。 + +```json +{ + "mcpServers": { + "internal-tools": { + "type": "http", + "url": "https://mcp.internal.example.com/mcp", + "oauth": { + "clientMetadataUrl": "https://auth.example.com/oauth/client-metadata.json" + } + } + } +} +``` + +**例: 公開クライアント認証を強制する** + +認可サーバーが confidential クライアント向けの方式を告知していても、デプロイで公開クライアントフローが必要な場合は `"none"` を強制します。 + +```json +{ + "mcpServers": { + "partner-api": { + "type": "http", + "url": "https://mcp.partner.example.com/mcp", + "oauth": { + "tokenEndpointAuthMethod": "none" + } + } + } +} +``` プロジェクトレベルの `.factory/mcp.json` はリポジトリにコミットされます。`headers` の認証トークン（例：`Authorization`）、`oauth.clientSecret`、API キーなどのシークレットは決してプロジェクト設定に入れないでください。これらはユーザーレベル設定（`~/.factory/mcp.json`）に置くか、環境変数で渡し、OAuth トークンには Droid の keyring を利用してください。 diff --git a/docs/jp/cli/configuration/settings.mdx b/docs/jp/cli/configuration/settings.mdx index 77889b159..791ed9b78 100644 --- a/docs/jp/cli/configuration/settings.mdx +++ b/docs/jp/cli/configuration/settings.mdx @@ -213,6 +213,24 @@ droidがターミナルでコンテンツをどのように描画するかを調 | `missionOrchestratorReasoningEffort` | string | `off`, `none`, `low`, `medium`, `high` | モデルのデフォルト | ミッションオーケストレーターの推論努力。 | | `keepSystemAwakeDuringMissions` | boolean | `true`, `false` | `true` | ミッション実行中にOSがスリープしないようにします。 | +## サブエージェント設定 + +Task ツールによって起動されるサブエージェントを設定します。これらは `/settings` の **Subagents** タブに表示されます。 + +| 設定 | 型 | オプション | デフォルト | 説明 | +| ------- | ------ | ------- | ------- | ----------- | +| `subagentAutonomyLevel` | string | `inherit`, `off`, `low`, `medium`, `high` | `inherit` | Task ツールによって起動されるサブエージェントに適用される[自律レベル](/jp/cli/user-guides/auto-run)。 | + +### サブエージェントの自律レベル + +`subagentAutonomyLevel` は、サブエージェントが承認なしでどこまで実行できるかを制御します： + +- **`inherit`** – サブエージェントは親セッションの自律レベルを使用します（デフォルト）。 +- **`off`** – サブエージェントはすべてのアクションで手動承認が必要です。 +- **`low`**, **`medium`**, **`high`** – そのリスクレベル以下のサブエージェント作業を事前承認します。 + +明示的なレベルを設定しても、組織管理の `maxAutonomyLevel` によって制限されるため、エンタープライズの上限を超えることはありません。ミッションワーカーにはこの設定は適用されません。 + ## コンテキストとコンパクション モデルのコンテキストウィンドウ内に収めるために、droidが会話をいつ・どのようにコンパクションするかを制御します。 diff --git a/docs/jp/cli/features/droid-control.mdx b/docs/jp/cli/features/droid-control.mdx index 549d02d00..b52b9640e 100644 --- a/docs/jp/cli/features/droid-control.mdx +++ b/docs/jp/cli/features/droid-control.mdx @@ -2,7 +2,7 @@ title: Droid Control sidebarTitle: ドロイド制御 description: ターミナル、ブラウザ、デスクトップの自動化。デモの記録、動作検証、QAフローの実行。 -keywords: ['droid-control', 'automation', 'demo', 'verify', 'qa-test', 'terminal', 'browser', 'recording', 'video', 'showcase', 'tuistory', 'remotion', 'tctl', 'plugin'] +keywords: ['droid-control', 'automation', 'demo', 'verify', 'qa-test', 'terminal', 'browser', 'desktop', 'desktop-control', 'cua-driver', 'computer-use', 'recording', 'video', 'showcase', 'tuistory', 'remotion', 'tctl', 'plugin'] --- Droid Controlは、Droidsがソフトウェアを*操作*できるようにします：アプリの起動、コマンドの入力、ボタンのクリック、動作の記録、そして洗練された動画証拠の生成を行います。Droidsによって、Droidsのために作られました。 @@ -181,9 +181,9 @@ PRリファレンスをオプションのクレームと共に受け付けます ## 自動化ドライバー -Droid Controlは3つの自動化バックエンドをサポートしています。対象に基づいて適切なものが自動的に選択されます。 +Droid Controlは4つの自動化バックエンドをサポートしています。対象に基づいて適切なものが自動的に選択されます。 - + **仮想PTY自動化。** ターミナル作業のデフォルト。asciinema録画と強制トゥルーカラー出力を備えたPlaywright風CLI。 @@ -193,6 +193,9 @@ Droid Controlは3つの自動化バックエンドをサポートしています **ウェブとElectronアプリ。** Chrome DevTools Protocolサポートを備えたPlaywrightベースのCLI。ページをナビゲートし、フォームを記入し、ボタンをクリックし、スクリーンショットを取得。 + + **ネイティブデスクトップアプリ。** [trycua/cua](https://github.com/trycua/cua) の `cua-driver` によるアクセシビリティツリーのスナップショット、要素またはピクセル単位の操作、ウィンドウごとのスクリーンショットを、フォーカスを奪わずに実行できます。macOSとWindowsは本番対応、Linuxはプレリリースです。 + ## ビデオレンダリング @@ -230,7 +233,7 @@ Droid Controlは3つの自動化バックエンドをサポートしています プラグインは3つのレイヤーからなる構成アーキテクチャを使用しています： - **オーケストレーター** -- 各リクエストを3つの独立したルックアップ（対象、ステージ、アーティファクト）を通じてルーティングし、読み込むスキルを決定します。 -- **10のアトムスキル** -- オンデマンドで読み込まれる自己完結型の背景知識で、ドライバー、対象、ステージ、ポリッシュに分割されています。 +- **11のアトムスキル** -- オンデマンドで読み込まれる自己完結型の背景知識で、ドライバー、対象、ステージ、ポリッシュに分割されています。 - **3つのコマンド** -- 引数をコミットメントに解析し、ハイブリッドハンドオフを介してアトムに委任します。 すべてのワークフローは**キャプチャ → 合成 → 検証**を通じて流れます。コマンドは*何を*生成するかを宣言し、アトムが*どのように*行うかを所有します。スキルはハードコードされたパイプラインではなく明示的なハンドオフを通じてチェーンするため、droidは自然にフローに従います。 @@ -259,6 +262,13 @@ Droid Controlは3つの自動化バックエンドをサポートしています agent-browser install # downloads Chromium ``` + + ```bash + curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh | bash + cua-driver skills install # upstream skill pack (deep tool reference) + ``` + WindowsではPowerShellで `irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iex` を実行してインストールします。macOSでは追加で `cua-driver permissions grant`（アクセシビリティ + 画面収録）が必要です。 + | プラットフォーム | 必要なツール | |----------|----------------| diff --git a/docs/jp/cli/features/missions/running-cli.mdx b/docs/jp/cli/features/missions/running-cli.mdx index 67bc0d982..a4270c376 100644 --- a/docs/jp/cli/features/missions/running-cli.mdx +++ b/docs/jp/cli/features/missions/running-cli.mdx @@ -1,7 +1,7 @@ --- title: "CLIでの実行" description: プランが承認されると、Droid は Mission Control に入ります。ターミナルから進捗を監視し、ワーカーのブロックを解除し、オーケストレーターをリダイレクトします。 -keywords: ['missions', 'mission control', 'orchestrator', 'intervene', 'redirect', 'cli'] +keywords: ['factory missions', 'missions', 'mission control', 'orchestrator', 'intervene', 'redirect', 'cli'] --- ## Mission Control での作業 diff --git a/docs/jp/cli/user-guides/choosing-your-model.mdx b/docs/jp/cli/user-guides/choosing-your-model.mdx index d757c6306..fdf82f5b6 100644 --- a/docs/jp/cli/user-guides/choosing-your-model.mdx +++ b/docs/jp/cli/user-guides/choosing-your-model.mdx @@ -16,7 +16,7 @@ keywords: ['model', 'models', 'llm', 'claude', 'sonnet', 'opus', 'haiku', 'gpt', | ランク | モデル | 選ぶ理由 | | ---- | ---- | ---- | -| 1 | **Claude Fable 5**\* | 初の一般公開された Mythos モデル；複数ステップの自律的なソフトウェアエンジニアリング作業に最適。4×価格設定。 | +| 1 | **Claude Fable 5**\*† | 初の一般公開された Mythos モデル；複数ステップの自律的なソフトウェアエンジニアリング作業に最適。4×価格設定。 | | 2 | **Claude Opus 4.8** | **Max**推論を持つ最新の Anthropic 主力モデル；最も困難な作業に最適。2×価格設定。 | | 3 | **Claude Opus 4.8 Fast** | より高速な応答時間向けに調整された Opus 4.8；4×価格設定。 | | 4 | **Claude Opus 4.7** | **Max**推論を持つ Anthropic 主力モデル；最も困難な作業に最適。2×価格設定。 | @@ -31,17 +31,22 @@ keywords: ['model', 'models', 'llm', 'claude', 'sonnet', 'opus', 'haiku', 'gpt', | 13 | **GPT-5.2-Codex** | **Extra High**推論を持つ実績のある OpenAI コーディングモデル；実装中心のタスクに堅実。 | | 14 | **GPT-5.2** | verbosity サポートと最大 **Extra High** までの推論を備えた OpenAI モデル。 | | 15 | **Claude Haiku 4.5** | ルーチンタスクや大量自動化向けに高速でコスト効率が高い。 | -| 16 | **Gemini 3.1 Pro** | 構造化出力に強く、リサーチ集約型タスク向けに混合推論制御を備えた新しい Gemini Pro 世代。 | -| 17 | **Gemini 3 Flash** | 高速で低コスト（0.2×価格設定）かつ完全な推論サポート付き；スピードが重要な大量タスクに最適。 | -| 18 | **Droid Core (NVIDIA Nemotron 3 Ultra)** | オープンソース、0.4×価格設定、高頻度の自動化向けに高速でコスト効率の高いモデル；画像サポートなし。 | -| 19 | **Droid Core (MiniMax M2.7)** | オープンソース、推論サポート（Low/Medium/High）と画像サポート付きの 0.12×価格設定；利用可能な中で最も安価なモデル。 | -| 20 | **Droid Core (GLM-5.1)** | オープンソース、0.55×価格設定、大量自動化とエアギャップ環境向けの新しい GLM オプション；画像サポートなし。 | -| 21 | **Droid Core (GLM-5)** | オープンソース、0.4×価格設定、大量自動化とエアギャップ環境向けの安定した選択肢；画像サポートなし。 | -| 22 | **Droid Core (Kimi K2.6)** | オープンソース、画像サポートと任意の High 推論付き 0.4×価格設定；思考トグルも欲しいコスト重視の作業に適している。 | -| 23 | **Droid Core (Kimi K2.5)** | オープンソース、画像サポート付き 0.25×価格設定；コスト重視の作業向けの旧 Kimi オプション。 | +| 16 | **Grok 4.5** | 最新の xAI Grok モデルで、混合推論（Low/Medium/High）に対応；0.8×価格設定でコスト効率にも優れた先端モデルの有力な選択肢。 | +| 17 | **Gemini 3.1 Pro** | 構造化出力に強く、リサーチ集約型タスク向けに混合推論制御を備えた新しい Gemini Pro 世代。 | +| 18 | **Gemini 3 Flash** | 高速で低コスト（0.2×価格設定）かつ完全な推論サポート付き；スピードが重要な大量タスクに最適。 | +| 19 | **Droid Core (NVIDIA Nemotron 3 Ultra)** | オープンソース、0.4×価格設定、高頻度の自動化向けに高速でコスト効率の高いモデル；画像サポートなし。 | +| 20 | **Droid Core (MiniMax M3)** | オープンソース、マルチモーダルな画像サポートと強力な agentic 機能を備えた 0.12×価格設定；拡張コンテキストを活かせる日常タスク向けの信頼できる主力モデル。 | +| 21 | **Droid Core (MiniMax M2.7)** | オープンソース、推論サポート（Low/Medium/High）と画像サポート付きの 0.12×価格設定；利用可能な中で最も安価なモデル。 | +| 22 | **Droid Core (GLM-5.1)** | オープンソース、0.55×価格設定、大量自動化とエアギャップ環境向けの新しい GLM オプション；画像サポートなし。 | +| 23 | **Droid Core (GLM-5)** | オープンソース、0.4×価格設定、大量自動化とエアギャップ環境向けの安定した選択肢；画像サポートなし。 | +| 24 | **Droid Core (Kimi K2.7 Code)** | コーディング特化の Kimi で、0.4×価格設定かつ任意の High 推論に対応；コスト重視の開発作業で強力な agentic 性能とツール使用能力を発揮。 | +| 25 | **Droid Core (Kimi K2.6)** | オープンソース、画像サポートと任意の High 推論付き 0.4×価格設定；思考トグルも欲しいコスト重視の作業に適している。 | +| 26 | **Droid Core (Kimi K2.5)** | オープンソース、画像サポート付き 0.25×価格設定；コスト重視の作業向けの旧 Kimi オプション。 | \* Anthropic では、すべての Mythos クラスのモデルに対して信頼と安全性のため 30 日間のデータ保持を求めています。詳しくは[こちら](https://support.claude.com/en/articles/15425996-data-retention-practices-for-mythos-class-models)を参照してください。 +† 2026年6月12日時点で、Claude Fable 5 は現在利用できません。詳細は Mythos アクセスに関する Anthropic の更新情報を[こちら](https://www.anthropic.com/news/fable-mythos-access)で確認してください。 + モデルの更新を定期的に配信しています。新しいリリースが上記のリストを上回る場合、 このページとCLIのデフォルトを更新します。 @@ -53,14 +58,14 @@ keywords: ['model', 'models', 'llm', 'claude', 'sonnet', 'opus', 'haiku', 'gpt', | シナリオ | 推奨モデル | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| **深い計画立案、アーキテクチャレビュー、曖昧な製品仕様** | 最高の深度と安全性のため**Opus 4.8**から始める、またはより高速な処理のため**Opus 4.7** / **Opus 4.6**にフォールバック。バランスの取れたコスト/品質なら**Sonnet 4.6**または**Sonnet 4.5**、大規模コンテキスト推論なら**GPT-5.4**を使用。 | +| **深い計画立案、アーキテクチャレビュー、曖昧な製品仕様** | 最高の深度と安全性のため**Opus 4.8**から始めるか、より高速な処理のため**Opus 4.7** / **Opus 4.6**にフォールバック。バランスの取れたコスト/品質なら**Sonnet 4.6**または**Sonnet 4.5**、大規模コンテキスト推論なら**GPT-5.4**を使用。 | | **フルフィーチャー開発、大規模リファクタリング** | 深度と安全性のため**Opus 4.8**または**Opus 4.7**。スピードと**Extra High**推論が必要な場合は**GPT-5.4**、**GPT-5.3-Codex**、または**GPT-5.2-Codex**；バランスの取れたループには**Sonnet 4.6**または**Sonnet 4.5**。 | | **反復可能な編集、要約、ボイラープレート生成** | スピードとコストのため**Haiku 4.5**または**Droid Core**（0.12×の**MiniMax M2.7**を含む）。より高い品質や構造化出力が必要な場合は**GPT-5.2**。 | | **CI/CDまたは自動化ループ** | 予測可能で低コストなスループットのため**Haiku 4.5**または**Droid Core**を優先。自動化により強力な推論が必要な場合は**GPT-5.3-Codex**または**GPT-5.4**を使用。 | | **大量自動化、頻繁なクイックターン** | 迅速なフィードバックのため**Haiku 4.5**。コストが重要または エアギャップ展開が必要な場合は**Droid Core**（特に推論付き0.12×の**MiniMax M2.7**）。 | - **Claude Opus 4.8**は、極めて複雑なアーキテクチャの決定や最大限の推論能力が必要な重要な作業のための最新の最上位オプションです。**Claude Opus 4.7**と**Claude Opus 4.6**は優秀な代替案であり、**Opus 4.6 Fast**はより高いコストでより高速な応答に調整されています。ほとんどのタスクはOpusレベルのパワーを必要としません—Sonnet 4.6またはSonnet 4.5から始めて、必要な場合のみエスカレートしてください。 + **Claude Opus 4.8**は、極めて複雑なアーキテクチャの決定や最大限の推論能力が必要な重要な作業に向けた最新の最上位オプションです。**Claude Opus 4.7**と**Claude Opus 4.6**も引き続き優れた代替候補であり、**Opus 4.6 Fast**はより高いコストでより高速な応答向けに調整されています。ほとんどのタスクはOpusレベルのパワーを必要としません—Sonnet 4.6またはSonnet 4.5から始めて、必要な場合のみエスカレートしてください。 ヒント：`/model`またはセッティングパネル（`Shift+Tab` → **Settings**）で切り替えることで、セッション中にモデルを変更できます。 @@ -89,6 +94,7 @@ keywords: ['model', 'models', 'llm', 'claude', 'sonnet', 'opus', 'haiku', 'gpt', - **GPT-5.3-Codex**: None / Low / Medium / High / **Extra High**（デフォルト：Medium） - **Gemini 3.1 Pro**: Low / Medium / High（デフォルト：High） - **Gemini 3 Flash**: Minimal / Low / Medium / High（デフォルト：High） +- **Grok 4.5**: Low / Medium / High（デフォルト：Medium） - **Droid Core (GLM-5)**: Noneのみ（デフォルト：None；画像サポートなし） - **Droid Core (GLM-5.1)**: Noneのみ（デフォルト：None；画像サポートなし） - **Droid Core (Kimi K2.6)**: Off / High（デフォルト：High） diff --git a/docs/jp/enterprise/enterprise-plugin-registry.mdx b/docs/jp/enterprise/enterprise-plugin-registry.mdx index c70361add..c53e72913 100644 --- a/docs/jp/enterprise/enterprise-plugin-registry.mdx +++ b/docs/jp/enterprise/enterprise-plugin-registry.mdx @@ -242,6 +242,35 @@ plugins/ プラグインごとの `version` フィールドによるバージョン固定は現在サポートされていません。プラグインのバージョンを固定するには、`ref` または `sha` を使用してプラグインが含まれるマーケットプレイスを固定してください。 +## プライベート npm レジストリ認証 + +トークンベース認証が必要なプライベートレジストリ（JFrog Artifactory、AWS CodeArtifact、GitHub Packages など）から npm パッケージとして配布するプラグインでは、プラグインソースの `authTokenEnvVar` フィールドを使って、認証トークンを保持する環境変数を指定します： + +```json +{ + "plugins": [ + { + "name": "internal-tools", + "description": "社内ツール用プラグイン", + "source": { + "source": "npm", + "package": "@acme/droid-internal-tools", + "registry": "https://acme.jfrog.io/artifactory/api/npm/npm-virtual/", + "authTokenEnvVar": "JFROG_NPM_TOKEN" + } + } + ] +} +``` + +インストール時に、Droid は指定された環境変数からトークンを読み取り、一時的な `.npmrc` にレジストリパス単位の `_authToken` エントリを書き込みます。トークンがインストール後にディスクへ永続化されることはありません。環境変数が設定されていない場合、インストールは早い段階で失敗し、どの変数を `export` すべきかを示す具体的なエラーが表示されます。 + +オンボーディング用ドキュメントでは、必要なトークンを開発者が `export` するよう案内してください： + +```bash +export JFROG_NPM_TOKEN="$(jfrog rt access-token-create --groups readers | jq -r .access_token)" +``` + ## プライベートリポジトリアクセス プライベートGitリポジトリの場合、Droidが認証できることを確認します： diff --git a/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx b/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx index 52650983e..fb792cbe2 100644 --- a/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx +++ b/docs/jp/enterprise/hierarchical-settings-and-org-control.mdx @@ -87,6 +87,10 @@ User → ~/.factory/ 任意のユーザーまたはプロジェクトが設定できる最大自律レベル。`off`、`low`、`medium`、`high` のいずれか + + Task ツールによって起動されるサブエージェントに適用される自律レベル。`inherit`、`off`、`low`、`medium`、`high` のいずれか。デフォルトは `inherit` で、親セッションの自律レベルにフォールバックします。明示的なレベルは `maxAutonomyLevel` によって制限されるため、エンタープライズの上限を超えることはありません。 + + セッションがクラウドに同期されるかどうか @@ -120,7 +124,7 @@ User → ~/.factory/ - `true` の場合、組織管理フックと組織が有効化したプラグインのフックのみが読み込まれます。ユーザーレベルおよびプロジェクトレベルで定義されたフックは無視されます。デフォルトは `false` で、すべてのレベルのフックが通常どおり参加します。[組織管理フック](/jp/reference/hooks-reference#org-managed-hooks) を参照してください。 + `true` の場合、組織管理フックと、組織が有効にしたプラグイン由来のフックのみが読み込まれます。ユーザーレベルおよびプロジェクトレベルで定義されたフックは無視されます。デフォルトは `false` で、すべてのレベルのフックが通常どおりマージされます。[組織管理フック](/jp/reference/hooks-reference#org-managed-hooks) を参照してください。 @@ -331,6 +335,7 @@ Factoryは、従来の「上書き」動作ではなく、**拡張のみ**のセ - `sessionDefaultSettings.model` - `sessionDefaultSettings.autonomyMode` - `maxAutonomyLevel` +- `subagentAutonomyLevel` これにより、組織の決定（どのモデルや自律レベルが許可されているかなど）が権威を保持することが保証されます。 @@ -462,6 +467,7 @@ Factoryは、従来の「上書き」動作ではなく、**拡張のみ**のセ "specModeReasoningEffort": "medium" }, "maxAutonomyLevel": "high", + "subagentAutonomyLevel": "inherit", "cloudSessionSync": true, "includeCoAuthoredByDroid": true, "enableDroidShield": true, diff --git a/docs/jp/enterprise/llm-safety-and-agent-controls.mdx b/docs/jp/enterprise/llm-safety-and-agent-controls.mdx index 8a05cf6e3..23096e517 100644 --- a/docs/jp/enterprise/llm-safety-and-agent-controls.mdx +++ b/docs/jp/enterprise/llm-safety-and-agent-controls.mdx @@ -22,6 +22,7 @@ Factory は LLM を強力であるが信頼できないコンポーネントと - グローバルおよびプロジェクトレベルの許可/拒否リスト - ファイルとリポジトリの保護 - Droid Shieldのシークレットスキャン + - 学習型分類モデル（リサーチプレビュー） - 適用とログ記録のためのフック - サンドボックス化されたVMとコンテナ diff --git a/docs/jp/enterprise/service-accounts.mdx b/docs/jp/enterprise/service-accounts.mdx index d33d840f7..0960f7be1 100644 --- a/docs/jp/enterprise/service-accounts.mdx +++ b/docs/jp/enterprise/service-accounts.mdx @@ -15,7 +15,7 @@ description: CI/CDパイプライン、スクリプト、Droid ComputersでFacto - Settingsから安定したIDを追加します。実行内容がチームに分かるよう、明確な名前と必要に応じた説明を付けてください。 + SettingsのAPIキーセクションから安定したIDを追加します。実行内容がチームに分かるよう、明確な名前と必要に応じた説明を付けてください。サービスアカウントを作成または編集できるのは、マネージャーとオーナーのみです。 スクリプト、CIジョブ、その他の自動化ワークロード用のキーを作成します。キーの値は一度しか表示されないため、コピーして安全に保管してください。 diff --git a/docs/jp/features/missions/overview.mdx b/docs/jp/features/missions/overview.mdx index d091bc924..b8b7c3b1e 100644 --- a/docs/jp/features/missions/overview.mdx +++ b/docs/jp/features/missions/overview.mdx @@ -1,7 +1,7 @@ --- title: "Factory Missions" description: Factory Missionsを使って、構造化されたオーケストレーションで複数機能にまたがる大規模プロジェクトを計画・実行します。目標を説明し、計画を共同作成し、作業管理をDroidに任せます。 -keywords: ['missions', 'mission', 'orchestration', 'multi-feature', 'milestones', 'skills', 'large projects', 'planning', 'mission control'] +keywords: ['factory missions', 'missions', 'mission', 'orchestration', 'multi-feature', 'milestones', 'skills', 'large projects', 'planning', 'mission control'] --- diff --git a/docs/jp/features/missions/planning.mdx b/docs/jp/features/missions/planning.mdx index 525f18622..1e3563605 100644 --- a/docs/jp/features/missions/planning.mdx +++ b/docs/jp/features/missions/planning.mdx @@ -1,7 +1,7 @@ --- title: 計画と検証 description: 計画段階は Missions が最も価値を発揮する場面です。機能とマイルストーンのスコープ設定、検証頻度の設定、コストと期間の見積もり方法を学びます。 -keywords: ['missions', 'planning', 'milestones', 'validation', 'cost', 'estimation'] +keywords: ['factory missions', 'missions', 'planning', 'milestones', 'validation', 'cost', 'estimation'] --- ## 計画段階が最も重要 @@ -18,6 +18,7 @@ Factory Missions において最も価値があるのは計画段階です。事 QAスタイルの検証を必要としないプロジェクトの場合は、Mission Control 内のミッション設定でこれを無効化できます。 + ## QAのための開発スクリプト ミッションは実行中のアプリケーションを動かすことで自らの作業を検証します。そのため、最も価値のある準備の一つは、Droid がアプリを立ち上げ、操作し、観察できるようにする信頼性の高いスクリプトです。私たちが見てきた良いパターンは次のとおりです。 @@ -36,7 +37,7 @@ QAスタイルの検証を必要としないプロジェクトの場合は、Mis 大まかな計画のヒューリスティックとして、ミッションの期間とコストはワーカーの実行回数に比例します： - **機能ワーカー：** 機能あたり約1回の実行 -- **検証ワーカー：** マイルストーンあたり約1回の実行 +- **検証ワーカー：** 各マイルストーンあたり2回の実行（検証が最初の試行で通る前提） つまり、初期見積もりは約： diff --git a/docs/jp/features/missions/reference.mdx b/docs/jp/features/missions/reference.mdx index d16873feb..e2991c911 100644 --- a/docs/jp/features/missions/reference.mdx +++ b/docs/jp/features/missions/reference.mdx @@ -1,7 +1,7 @@ --- title: 設定とリファレンス description: 設定の継承、droid exec --mission によるヘッドレス実行、ミッション設定、組織のアクセスポリシー。 -keywords: ['missions', 'reference', 'droid exec', 'headless', 'settings', 'missionModelSettings', 'missionPolicy', 'configuration'] +keywords: ['factory missions', 'missions', 'reference', 'droid exec', 'headless', 'settings', 'missionModelSettings', 'missionPolicy', 'configuration'] --- ## 設定の継承 diff --git a/docs/jp/features/missions/troubleshooting.mdx b/docs/jp/features/missions/troubleshooting.mdx index 2ef1c4fe7..6c6b0e947 100644 --- a/docs/jp/features/missions/troubleshooting.mdx +++ b/docs/jp/features/missions/troubleshooting.mdx @@ -7,36 +7,36 @@ keywords: ['factory missions', 'missions', 'troubleshooting', 'stuck', 'frozen', Factory Missions は設定したら放置するものではありません。オーケストレーターはエージェントであり、会話することができます。問題が起きたときに最も効果的なのは、オーケストレーターを一時停止し、見えている状況を平易な言葉で説明し、復旧を依頼することです。以下のシナリオは、私たちが最もよく遭遇する問題と、応用できる例文をまとめたものです。 - - missionが止まって何も起きていないように見える場合は、オーケストレーターを一時停止し、見えている状況を伝えます。直接的に、missionが停止または壊れているように見えること、最後に見えたアクティビティ、復旧してほしいことを説明してください。オーケストレーターは状態を再評価し、再開できます。 + + ミッションが止まって何も起きていないように見える場合は、オーケストレーターを一時停止し、見えている状況を伝えます。率直に、ミッションが停止または壊れているように見えること、最後に見えたアクティビティ、復旧してほしいことを説明してください。オーケストレーターは状態を再評価し、再開できます。 - **例:** *"The mission seems frozen -- the last worker finished 10 minutes ago and nothing new has started. Re-assess and continue."* + **例:** *「ミッションが停止しているようです。最後のワーカーは10分前に完了しましたが、その後何も始まっていません。状況を再評価して続行してください。」* - 1つのworkerが意味のある進捗なしに長時間タスクで止まっている場合、完了を待つ必要はありません。オーケストレーターを一時停止し、現在の項目を完了としてマークして次へ進むよう伝えます。その項目には後で戻ることも、手動で対応することもできます。 + 1つのワーカーが意味のある進捗なしに長時間タスクで止まっている場合、完了を待つ必要はありません。オーケストレーターを一時停止し、現在の項目を完了としてマークして次へ進むよう伝えます。その項目には後で戻ることも、手動で対応することもできます。 - **例:** *"The worker on the auth integration has been stuck for 20 minutes. Mark it as complete and move to the next feature."* + **例:** *「認証連携を担当しているワーカーが20分間詰まっています。完了としてマークして、次の機能に進んでください。」* - + 以前の前提が間違っていたり、依存関係が不足していたりして、オーケストレーターがブロックされたマイルストーンに到達することがあります。この場合は、残りの作業を再評価し、なぜブロックされたのかを特定するよう依頼します。障害を回避する再計画、機能の並べ替え、マイルストーン範囲の調整が可能です。 - **例:** *"We are stuck on Milestone 3. Re-assess the remaining work and tell me what is blocking progress."* + **例:** *「マイルストーン3で詰まっています。残りの作業を再評価し、何が進行を妨げているのか教えてください。」* - + 計画を変更する必要があると気づいた場合（機能を削除する、新しい要件が入った、アプローチが間違っているなど）は、一時停止してオーケストレーターに伝えます。計画を更新し、マイルストーンのスコープを見直し、新しい方向から続行できます。 - **例:** *"Drop the email notification feature and add Slack integration instead. Re-plan the remaining milestones."* + **例:** *「メール通知機能を削除して、代わりに Slack 連携を追加してください。残りのマイルストーンを再計画してください。」* - *"Feature retry limit reached. A feature kept failing..."* のようなメッセージは、特定の機能が繰り返し失敗し、オーケストレーターがその再試行を停止したことを意味します。その機能の最新のワーカーを調べ、なぜ失敗し続けるのかを特定してください。多くの場合、これはユーザーテスト用バリデーターであり、アプリケーションを正しく QA できないこと、つまりミッションにアプリを確実に立ち上げて動かす手段がないことを示しています。アプリの依存関係を立ち上げるかモックして QA が実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning) を参照してください。QAスタイルの検証が不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化してください。 + *"Feature retry limit reached. A feature kept failing..."* のようなメッセージは、特定の機能が繰り返し失敗し、オーケストレーターがその再試行を停止したことを意味します。その機能の最新のワーカーを調べ、なぜ失敗し続けるのかを特定してください。多くの場合、これは user-testing バリデーターであり、アプリケーションを正しく QA できないこと、つまりミッションにアプリを確実に立ち上げて動かす手段がないことを示しています。アプリの依存関係を立ち上げるかモックして QA が実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning#development-scripting-for-qa) を参照してください。QAスタイルの検証が不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化してください。 - 検証ワーカーが繰り返し失敗する場合、実行中のアプリケーションを確実に動かす手段がミッションに不足していることがよくあります。アプリの依存関係を立ち上げるかモックしてQAが実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning) を参照してください。QAスタイルの検証がそもそも不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化できます。 + 検証ワーカーが繰り返し失敗する場合、実行中のアプリケーションを確実に動かす手段がミッションに不足していることがよくあります。アプリの依存関係を立ち上げるかモックしてQAが実際のユーザーフローをシミュレートできるスクリプトを用意し、ログが Droid の確認できるファイルシステムに書き出されていることを確認してください。[計画と検証](/jp/features/missions/planning#development-scripting-for-qa) を参照してください。QAスタイルの検証がそもそも不要なプロジェクトの場合は、Mission Control 内のミッション設定で無効化できます。 diff --git a/docs/jp/guides/building/building-plugins.mdx b/docs/jp/guides/building/building-plugins.mdx index f5c0d2c06..463a8816f 100644 --- a/docs/jp/guides/building/building-plugins.mdx +++ b/docs/jp/guides/building/building-plugins.mdx @@ -327,11 +327,180 @@ my-marketplace/ | `description` | いいえ | マーケットプレースを閲覧時に表示 | | `owner` | いいえ | 連絡先情報 | | `plugins[].name` | はい | プラグイン識別子 | -| `plugins[].source` | はい | プラグインディレクトリへの相対パス | +| `plugins[].source` | はい | プラグインの取得元。相対パス文字列または source オブジェクトです。[プラグインソース](#plugin-sources)を参照してください。 | | `plugins[].description` | いいえ | プラグインブラウザに表示 | | `plugins[].category` | いいえ | プラグインを整理するため | -### バージョン管理 +### プラグインソース {#plugin-sources} + +各プラグインエントリの `source` フィールドは、Droid にプラグインの取得元を伝えます。既定の形式である `"./plugin-one"` のような相対パス文字列は、マーケットプレースリポジトリ内のディレクトリを指します。別の場所にあるプラグインには、source オブジェクトを使用します。 + +固定方法はソースタイプによって異なります。Git ベースのソース（`github`、`url`、`git-subdir`）は、`ref`（ブランチまたはタグ）または `sha` によりプラグインごとに固定されます。相対パスのプラグインは、それらが含まれているマーケットプレースソースを固定することで固定されます。`npm` プラグインは `version` フィールドで固定され、npm のバージョン解決に従います。 + +| ソースタイプ | フィールド | 使用する場面 | +| :---------- | :----- | :------- | +| 相対パス | `"./path/to/plugin"` | プラグインがマーケットプレースリポジトリ内にある場合。 | +| `github` | `repo`, `ref?`, `sha?` | プラグインが専用の GitHub リポジトリでホストされている場合。 | +| `url` | `url`, `ref?`, `sha?` | プラグインが GitHub 以外の git ホスト（GitLab、Bitbucket、セルフホストなど）でホストされている場合。 | +| `git-subdir` | `url`, `path`, `ref?`, `sha?` | モノレポなどの大きな git リポジトリ内のサブディレクトリにプラグインがある場合。 | +| `npm` | `package`, `version?`, `registry?`, `authTokenEnvVar?` | プラグインが npm パッケージとして公開されている場合。 | + +#### npm パッケージ + +すでにプライベートレジストリ（Artifactory、CodeArtifact、GitHub Packages、Verdaccio など）へ配布しており、その経路を Droid プラグインにも再利用したい場合は、プラグインを npm パッケージとして配布します。npm レジストリ上の公開パッケージも同様に動作します。npm ソースでは、固定と更新は `version` フィールドによる npm のバージョン解決に従います。[バージョン管理](#version-management) にある Git コミットハッシュの指針は、Git ベースのソースにのみ適用されます。 + +`npm` がインストールされ、`PATH` から利用できる必要があります。利用できない場合、CLI は明確なエラーを表示します。 + +```json +{ + "name": "pr-triage", + "source": { + "source": "npm", + "package": "@your-org/droid-pr-triage" + } +} +``` + +特定のバージョンまたは範囲に固定するには: + +```json +{ + "name": "pr-triage", + "source": { + "source": "npm", + "package": "@your-org/droid-pr-triage", + "version": "2.4.0" + } +} +``` + +プライベートレジストリからインストールするには: + +```json +{ + "name": "pr-triage", + "source": { + "source": "npm", + "package": "@your-org/droid-pr-triage", + "version": "^2.0.0", + "registry": "https://npm.your-org.example" + } +} +``` + +トークンが必要なプライベートレジストリ（たとえば JFrog Artifactory、AWS CodeArtifact、GitHub Packages）で認証するには: + +```json +{ + "name": "pr-triage", + "source": { + "source": "npm", + "package": "@your-org/droid-pr-triage", + "registry": "https://acme.jfrog.io/artifactory/api/npm/npm-virtual/", + "authTokenEnvVar": "JFROG_NPM_TOKEN" + } +} +``` + +ユーザーは Droid を起動する前に、指定された環境変数を設定しておく必要があります: + +```bash +# bash/zsh +export JFROG_NPM_TOKEN="your-token-here" +``` + +```powershell +# PowerShell +$env:JFROG_NPM_TOKEN="your-token-here" +``` + + +トークンをソース管理にコミットしたり、マーケットプレース JSON に貼り付けたりしないでください。`authTokenEnvVar` フィールドには、シークレットそのものではなく環境変数名だけが保存されます。 + + +| フィールド | 必須 | 説明 | +| :---- | :------- | :---------- | +| `package` | はい | npm パッケージ名。スコープ付きパッケージ（`@scope/name`）にも対応します。 | +| `version` | いいえ | npm のバージョン、範囲、または dist-tag（例: `2.4.0`、`^2.0.0`、`latest`）。既定値は `latest` です。tarball URL、`file:` パス、`git+...` 指定、`npm:` エイリアスは拒否されます。ソースは設定済みレジストリ経由で解決される必要があります。 | +| `registry` | いいえ | カスタムレジストリ URL。既定ではシステムの npm レジストリを使用します。認証情報、クエリ文字列、フラグメントを埋め込まない `https://` URL である必要があります。これにより、シークレットはマーケットプレース JSON ではなくレジストリクライアント設定に保持されます。この設定はインストール実行時にのみ適用され、グローバルな `~/.npmrc` に書き込まれることはありません。 | +| `authTokenEnvVar` | いいえ | プライベートレジストリ用の認証トークンを保持する環境変数名（例: `JFROG_NPM_TOKEN`）。有効なシェル変数名（`[A-Za-z_][A-Za-z0-9_]*`）である必要があります。`registry` も設定されている場合にのみ有効です。インストール時に、Droid はこの変数からトークンを読み取り、一時的な `.npmrc` にレジストリパス単位の `_authToken` エントリを書き込みます。この `.npmrc` はインストール後にクリーンアップされます。変数が設定されていない場合、インストールは明確なエラーを出して早い段階で失敗します。 | + +**レイアウト要件。** 公開パッケージのルートにはプラグインマニフェストが含まれている必要があります。Droid ネイティブのレイアウト（`.factory-plugin/plugin.json`、`droids/`、`mcp.json`）と Claude Code のレイアウト（`.claude-plugin/plugin.json`、`agents/`、`.mcp.json`）の両方を受け付けます。Claude Code レイアウトは、パッケージがプラグインキャッシュにコピーされる際に Droid 形式へ変換されます。 + +一般的な公開パッケージの構成は次のとおりです: + +``` +@your-org/droid-pr-triage/ +├── .factory-plugin/ +│ └── plugin.json +├── package.json +├── skills/ +│ └── classify/ +│ └── SKILL.md +├── droids/ +│ └── triage-reviewer.md +└── README.md +``` + +プラグイン本体だけが配布されるよう、`package.json` の `files` フィールドを設定します: + +```json +{ + "name": "@your-org/droid-pr-triage", + "version": "2.4.0", + "files": [ + ".factory-plugin", + "skills", + "droids", + "mcp.json", + "hooks", + "README.md" + ] +} +``` + +**ハードニング。** Droid はプラグインごとの一時ディレクトリで `npm install` を `--ignore-scripts`、`--no-save`、`--no-audit`、`--no-fund` とともに実行します。ライフサイクルスクリプト（`postinstall`、`preinstall` など）は実行されず、グローバルな npm 設定も参照・変更されません。ライフサイクルスクリプトはスキップされるため、`postinstall` のビルドステップに依存するパッケージでは利用可能な内容が配布されません。事前ビルド済み成果物を公開し（`npm publish` の前にビルドを実行し）、`files` の許可リスト配下の内容をそのまま利用できる状態にしてください。 + + +`npm:` は有効なマーケットプレースソースではありません。Droid が `npm` を受け付けるのは、マーケットプレースの `marketplace.json` 内にあるプラグインごとのソースとしてのみです。完全なマーケットプレースリポジトリを用意せずに、npm で公開した単一プラグインをチームに配布したい場合は、最小のラッパーマーケットプレースを公開してください（以下を参照）。 + + +##### 単一の npm プラグイン向けラッパーマーケットプレース + +専用のマーケットプレースリポジトリなしで npm 公開済みプラグインを 1 つ配布するには、任意のフォルダに小さな `marketplace.json` をコミットします。フォルダ名がそのままマーケットプレース名になります。 + +``` +your-org-plugins/ +└── .factory-plugin/ + └── marketplace.json +``` + +```json +{ + "name": "your-org-plugins", + "owner": { "name": "Your Org Platform Team" }, + "plugins": [ + { + "name": "pr-triage", + "description": "Triage and label new pull requests for the on-call rotation", + "source": { + "source": "npm", + "package": "@your-org/droid-pr-triage", + "version": "^2.0.0" + } + } + ] +} +``` + +チームメイトは、他のローカルマーケットプレースと同様に追加できます: + +```bash +droid plugin marketplace add ./your-org-plugins +droid plugin install pr-triage@your-org-plugins +``` + +### バージョン管理 {#version-management} ドキュメント目的でプラグインマニフェストではセマンティックバージョニングを使用します： @@ -340,7 +509,7 @@ my-marketplace/ - **パッチ**（1.0.0 → 1.0.1）：バグ修正 -DroidはプラグインバージョンをセマンティックバージョンではなくGitコミットハッシュで追跡します。デフォルトでは、プラグインを更新するとマーケットプレイスから最新のコミットを取得します。プラグインを特定のバージョンに固定するには、マーケットプレイスソースに `ref`（ブランチまたはタグ）または `sha`（フルコミットSHA）を設定して、プラグインが含まれるマーケットプレイスを固定してください。詳細は[マーケットプレイスをrefまたはコミットに固定する](/jp/cli/configuration/plugins#%E3%83%9E%E3%83%BC%E3%82%B1%E3%83%83%E3%83%88%E3%83%97%E3%83%AC%E3%82%A4%E3%82%B9%E3%82%92ref%E3%81%BE%E3%81%9F%E3%81%AF%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E3%81%AB%E5%9B%BA%E5%AE%9A%E3%81%99%E3%82%8B)を参照してください。 +Git ベースのプラグインソース（相対パス、`github`、`url`、`git-subdir`）では、Droid はセマンティックバージョンではなく Git コミットハッシュでプラグインバージョンを追跡します。デフォルトでは、プラグインを更新するとマーケットプレースから最新のコミットを取得します。プラグインを特定のバージョンに固定するには、マーケットプレースソースに `ref`（ブランチまたはタグ）または `sha`（フルコミット SHA）を設定して、プラグインが含まれるマーケットプレースを固定してください。詳細は[マーケットプレースをrefまたはコミットに固定する](/jp/cli/configuration/plugins#%E3%83%9E%E3%83%BC%E3%82%B1%E3%83%83%E3%83%88%E3%83%97%E3%83%AC%E3%82%A4%E3%82%B9%E3%82%92ref%E3%81%BE%E3%81%9F%E3%81%AF%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E3%81%AB%E5%9B%BA%E5%AE%9A%E3%81%99%E3%82%8B)を参照してください。`npm` プラグインソースでは、代わりにプラグインごとの `version` フィールドに従って固定されます。 ## Claude Code互換性 diff --git a/docs/jp/guides/droid-exec/code-review.mdx b/docs/jp/guides/droid-exec/code-review.mdx index 434250499..5ef055edb 100644 --- a/docs/jp/guides/droid-exec/code-review.mdx +++ b/docs/jp/guides/droid-exec/code-review.mdx @@ -39,6 +39,51 @@ droid 5. 問題のある行にインラインコメントを投稿 6. 問題が見つからない場合は承認を送信 +## 認証 + +自動レビューには、Droidを実行する権限と、プルリクエストに投稿する権限という、2種類の別々のアクセスが必要です。これらはそれぞれ独立して設定します。 + +### 1. Factory API key（Droidを実行） + +DroidはFactory API keyを使用して実行されます。[app.factory.ai/settings/api-keys](https://app.factory.ai/settings/api-keys)でキーを作成し、`FACTORY_API_KEY`という名前のシークレットとしてリポジトリまたは組織に追加してください。ワークフローでは次のように渡します： + +```yaml +- uses: Factory-AI/droid-action@main + with: + factory_api_key: ${{ secrets.FACTORY_API_KEY }} +``` + +これはすべての実行で必須です。 + +### 2. GitHub access（レビューを投稿） + +PRにコメントや承認を残すには、DroidにGitHub tokenが必要です。指定方法は2つあります： + +- **Factory Droid GitHub App（デフォルト、推奨）**。tokenを指定しない場合、actionはインストール済みのFactory Droid GitHub App用のtokenを安全に要求します。ほとんどのチームではこれだけで十分です。[app.factory.ai/settings/organization](https://app.factory.ai/settings/organization)から対象のリポジトリにAppをインストールすれば完了です。actionがtokenを要求できるように、`id-token: write` 権限が必要です： + + ```yaml + permissions: + contents: write + pull-requests: write + issues: write + id-token: write # GitHub App認証に必須 + ``` + +- **独自のtoken（オーバーライド）**。GitHub Enterpriseで利用する場合や、どのアカウントでコメントを投稿するかを制御したい場合など、personal access tokenや独自のGitHub Appを使いたいなら、`github_token`として渡します。設定すると、Droidはそのtokenを直接使用し、Appはスキップされます。このtokenにはpull requestとrepository contentsへの書き込み権限が必要です。 + + ```yaml + - uses: Factory-AI/droid-action@main + with: + factory_api_key: ${{ secrets.FACTORY_API_KEY }} + github_token: ${{ secrets.MY_GITHUB_TOKEN }} + ``` + + + GitLabでも必要な要素は同じです。`FACTORY_API_KEY`と`GITLAB_TOKEN`をCI/CD変数として設定してください。`/install-code-review`フローが両方を設定します。 + + +GitHub Appのセキュリティアーキテクチャについては、[GitHub統合セキュリティ](/enterprise/github-integration-security)を参照してください。 + ## レビューの深度 `review_depth` 入力は各レビューの徹底さとコストを制御します。`/install-code-review` セットアップ時に深度を選択するか、ワークフローで直接設定します。 diff --git a/docs/jp/integrations/slack.mdx b/docs/jp/integrations/slack.mdx index b509dad95..fe481c66e 100644 --- a/docs/jp/integrations/slack.mdx +++ b/docs/jp/integrations/slack.mdx @@ -3,25 +3,37 @@ title: "Slack" description: "FactoryとSlackワークスペースを接続する手順ガイド" --- -このガイドでは、FactoryとSlackを統合し、FactoryとあなたのSlack会話間でシームレスなやり取りを可能にするプロセスを説明します。 +FactoryをSlackに接続すると、DroidがSlack上の会話やチームのコンテキストを利用できるようになります。 + + +Factory Slack appがすでにワークスペースにインストールされている場合でも、以下のSlackインストールフローを再実行してください。これにより、DroidがSlackスレッド内の画像をコンテキストとして取り込み、動画、生成されたアーティファクト、その他のファイルをSlackに投稿できるようになります。Slackワークスペースの設定によっては、Adminの承認が必要になる場合があります。 + ## 前提条件 - 管理者権限を持つFactoryアカウント -- SlackワークスペースへのAdmin アクセス +- SlackワークスペースのAdmin権限 - Slackワークスペースでアプリをインストールする権限 ## 統合手順 - - Factoryアカウントにログインし、SettingsのIntegrationsセクションに移動します。 + + [Factoryアカウントにログイン](https://app.factory.ai)し、[**Settings** → **Organization**](https://app.factory.ai/settings/organization) を開いて、**Org Integrations** の **Slack** を探します。 + + + Org Integrations の Slack を表示している Factory の Organization 設定ページ + - Slackの横にある"Connect"をクリックして連携プロセスを開始します。 + **Connect** をクリックします。Slackがすでにインストールされている場合は **Manage** をクリックして連携プロセスを開始します。既存のSlackインストールを最新の権限に更新する場合は、連携詳細の **Reconnect** をクリックしてインストールフローを再実行します。 + + + Reconnect ボタンを表示している Factory の Slack 連携詳細画面 + - - Slackにリダイレクトされます。要求された権限を確認し、"Allow"をクリックしてFactoryにSlackワークスペースへのアクセスを許可します。 + + Slackにリダイレクトされます。要求された権限を確認し、**Allow** をクリックしてFactoryにSlackワークスペースへのアクセスを許可します。 複数のワークスペースに所属している場合は、Factoryに接続するワークスペースを選択します。 @@ -39,31 +51,75 @@ description: "FactoryとSlackワークスペースを接続する手順ガイド 統合が正しく動作していることを確認するには： 1. アプリが追加されたチャンネル内のスレッドで `@Factory` をメンションします。 -2. FactoryがFactory内で会話を開くためのリンクで応答することを確認します。 +2. Factoryが、その会話をFactoryで開くためのリンク付きで応答することを確認します。 3. リンクをクリックし、Slackスレッドの内容が新しいFactoryセッションに表示されることを確認します。 +4. 最新の権限のためにインストールフローを再実行した場合は、画像添付を含むスレッドでテストし、Droidがそれをコンテキストとして利用できることを確認します。 +5. ワークフローが結果をSlackに返す場合は、Droidが生成ファイルまたは短い結果動画をそのスレッドにアップロードできることを確認します。 -## Slack ツール +## 機能 - -以下のツールを使用する前に、操作したいチャンネルにFactoryアプリが招待されていることを確認してください -対象チャンネルで/invite @Factoryを送信します。 - +Slack連携では、次のことができます。 + + + + + +- 任意のSlackスレッドで `@Factory` をメンションして、そのスレッドからDroidセッションを開始する +- WebまたはDesktopでセッションを継続する +- 提供されたリンクをクリックして、Slackスレッド全体のコンテキストをFactoryにインポートする +- Slackの対応画像添付をセッションのコンテキストとして含める +- Droidにメッセージ、生成ファイル、アーティファクト、結果動画をSlackへ投稿させる +- アクティブなDroidセッションに対して、Slackからフォローアップメッセージや添付ファイルを送る +- **好きなモデルを選べ、ロックインはありません。** Factoryはモデル非依存で、Claude、GPT、Gemini、オープンソース/Droid Core、その他30以上のサポート対象モデルから選べます +- セッション開始時にモデルを選択したり、Auto-Runやサービスアカウントのワークフロー向けにチャンネルごとのデフォルトの **Model** を設定したり、[Factory Router](/jp/web/factory-router) に最適なモデル選択を自動で任せたりできます +- FactoryチャットにスレッドURLを貼り付けて、FactoryでSlackスレッドを参照する + + + Factory models を表示しているモデルピッカー付きの Factory Session Settings ダイアログ + + +PRを作成する際、Slack連携はCIを処理するサブエージェントも利用するため、エージェントの応答が速くなります。 -Factoryは現在、1つのネイティブSlackツールを提供しています： +Slackスレッドがインポートされると、Factoryは会話履歴全体にアクセスできるため、コンテキストを考慮した支援を提供できます。 -| ツール | 機能 | -| ---- | ------------ | -| **Post Message** | チャンネルにメッセージを送信、または既存のスレッドに返信 | +## Slack設定 -## 追加機能 +Slackを接続したら、[**Settings** → **Organization**](https://app.factory.ai/settings/organization) の **Manage** をクリックしてSlackチャンネル設定を構成します。これらの設定が必要なのはIncident Responseとサービスアカウントのワークフローだけで、通常の `@Factory` メンションはここでチャンネルを設定しなくても動作します。 -上記のツールに加えて、Slack統合では以下も可能です： +チャンネル設定では、チャンネルを有効にして行を展開し、**Run as**、**Incident Response**、**Machine Type**、**Computer** または **Workspace**、**Session Visibility**、**Model**、**Custom Prompt** を設定できます。この一覧には、Factoryアプリが招待されているチャンネルだけが表示されます。 -- 任意のSlackスレッドで `@Factory` をメンションして、Factoryで会話を続けるためのリンクを受け取る -- 提供されたリンクをクリックしてSlackスレッドのコンテキストをFactoryにインポート -- FactoryチャットにスレッドURLを貼り付けて、FactoryでSlackスレッドを参照 +## サービスアカウント + +Slackセッションを、`@Factory` をメンションしたSlackユーザーではなく、共有IDと事前設定済みのDroid Computerから実行したい場合は、[サービスアカウント](/jp/enterprise/service-accounts) を使用します。これは、一貫した認証情報とツールアクセスが必要なインシデント、運用、リリース用チャンネルに便利です。 + +Slackでサービスアカウントを使う前に、次を確認してください。 + +- 組織でサービスアカウントが有効になっている。 +- サービスアカウントが有効な状態である。 +- サービスアカウントが少なくとも1台のDroid Computerを所有している。 +- FactoryアプリがSlackチャンネルに招待されている。 + + + + Factoryで **Settings** → **Integrations** → **Slack** → **Channels** に移動します。チャンネルを有効にして、その設定を展開します。 + + + **Run as** の行が表示されたら、サービスアカウントを選択します。サービスアカウントを選ぶと、そのチャンネルはそのサービスアカウントのIDとコンピューターで実行されます。 + + + サービスアカウントのSlackセッションはDroid Computersで実行されます。サービスアカウントを選択すると、Factoryは実行先を **Computer** に固定し、そのサービスアカウントが所有するコンピューターだけを表示します。 + + + チャンネルの自動ワークフローでは、**Auto-Run** を有効にし、そのチャンネルのプロンプト、モデル、公開範囲を設定します。 + + + チャンネルで `@Factory` をメンションするか、Auto-Runが有効ならテストアラートを送信します。Factoryは選択したサービスアカウントとしてセッションを開始します。 + + -Slackスレッドがインポートされると、Factoryは会話履歴全体にアクセスできるため、コンテキストを考慮したアシスタンス機能を提供できます。 +アドホックなSlackセッションでは、コンピューターピッカーにも **Run as** セレクターが表示されることがあります。サービスアカウントを選択し、そのサービスアカウントのコンピューターの1つを選び、必要に応じて今後のSlackメンションのデフォルトとして保存できます。 ## ベストプラクティス @@ -78,6 +134,7 @@ Slackスレッドがインポートされると、Factoryは会話履歴全体 - FactoryとSlackワークスペースの両方で管理者権限を持っていることを確認する。 - メンションしようとしているチャンネルにFactoryアプリが追加されていることを確認する。 +- Droidが画像添付を読み取れない、またはファイルや動画をアップロードできない場合は、上記のSlackインストールフローを再実行してFactory Slack appの権限を更新する。 - SlackスレッドURLを貼り付ける際に「not_in_channel」エラートーストが表示される場合、そのチャンネルにFactoryボットを招待する必要があります。この問題を解決するには、チャンネルで `/invite @Factory` を使用してください。 - 組織のファイアウォールがwebhook通信をブロックしていないか確認する。 - 問題が解決しない場合は、具体的なエラーメッセージと共にFactoryサポートに連絡する。 diff --git a/docs/jp/reference/hooks-reference.mdx b/docs/jp/reference/hooks-reference.mdx index 6ec1a85af..f6aec2053 100644 --- a/docs/jp/reference/hooks-reference.mdx +++ b/docs/jp/reference/hooks-reference.mdx @@ -25,7 +25,7 @@ Droidフックは各スコープの`hooks.json`に保存され、[`settings.json ### 組織管理フック -組織は、[Enterprise Controls](https://app.factory.ai) の **Hooks Policy** セクションを通じて権威あるフックを一元的に定義でき、組織管理設定に保存されます。これにより管理者は標準フックをすべてのマシンに配布でき、必要に応じてすべての非管理フックを無視できます。 +組織は、[Enterprise Controls](https://app.factory.ai) の **Hooks Policy** セクションを通じて、組織管理設定に保存される強制力のあるフックを一元的に定義できます。これにより、管理者は標準フックをすべてのマシンに配布し、必要に応じて非管理フックをすべて無視できます。 | フィールド | 型 | 説明 | | :---- | :--- | :---------- | diff --git a/docs/jp/web/automations.mdx b/docs/jp/web/automations.mdx new file mode 100644 index 000000000..50a645c44 --- /dev/null +++ b/docs/jp/web/automations.mdx @@ -0,0 +1,115 @@ +--- +title: Automations +description: ソフトウェアデリバリーライフサイクル全体でワークフローを実行する Factory の自動化を作成・管理します。 +keywords: ['automations', 'software factory', 'scheduled automations', 'slack automations', 'github automations', 'code review', 'qa', 'autowiki', 'security audit', 'triage'] +--- + +Automations は、繰り返し発生するエンジニアリング作業で Droid をチームメイトのように活用できるようにします。スケジュール、Slack メッセージ、GitHub イベントから実行でき、コードレビュー、QA、AutoWiki、セキュリティ監査、トリアージ、インシデント対応、Slack からの依頼受付、定期チェックをカバーします。 + + + Factory App の Automations 一覧 + + +## Automations とは + +自動化には次の要素があります。 + +- **トリガー**: 開始するタイミング。 +- **指示**: Droid に委任するプロンプト。 +- **実行ターゲット**: Droid が実行される場所。たとえばコンピューター、Slack チャンネル、GitHub workflow など。 +- **公開範囲**: 閲覧または管理できるユーザー。 + +### Automations を使うタイミング + +ワークフローを繰り返し実行したいとき、イベントを起点に開始したいとき、または毎回手動で処理するのではなくチームで共有したいときに Automations を使用します。 + +## Automations の使い方 + +### 自分の自動化を表示する + +Factory App のサイドバーで **Software Factory** 配下の [**All Automations**](https://app.factory.ai/automations) を開きます。一覧では次のことができます。 + +- タイトル、説明、SDLC ステージで検索する。 +- **Private** と **Shared** を切り替える。 +- **Scheduled**、**Slack**、**GitHub** のトリガー種別で絞り込む。 +- 所有者、ステータス、実行ターゲット、SDLC ステージを確認する。 + +### 新しい自動化を作成する + +**New automation** をクリックし、テンプレートを選択します。Software Factory テンプレートは SDLC ステージに対応しており、カスタムテンプレートは独自のトリガーやワークフローを作るための柔軟な出発点になります。 + + + 自動化テンプレートギャラリー + + +#### Software Factory テンプレート + +Software Factory の特定の SDLC ステージに自動化を追加するには、これらのテンプレートを使用します。 + +| テンプレート | 用途 | +| --- | --- | +| **Code Review** | PR を自動でレビューします。 | +| **QA** | QA チェックを生成して実行します。 | +| **AutoWiki** | リポジトリドキュメントを更新します。 | +| **Security Audit** | スケジュールに従って詳細なセキュリティレビューを実行します。 | +| **Triage** | インテークソースをスキャンして作業を振り分けます。 | +| **Incident Response** | Slack チャンネルからのアラートを調査します。 | + +#### カスタムテンプレート + +独自のチャンネル、スケジュール、GitHub イベントに基づく自動化を作成するには、これらのテンプレートを使用します。 + +| テンプレート | 用途 | +| --- | --- | +| **Slack** | Slack メッセージから Droid セッションを開始します。 | +| **Scheduled** | 定期スケジュールでプロンプトを実行します。 | +| **GitHub** | カスタム GitHub workflow イベントから Droid を実行します。 | + +### トリガーを設定する + +テンプレートを選択すると、Factory がトリガーと実行先に合わせて設定項目を調整します。 + + + Slack 自動化の作成フォーム + + +| トリガー種別 | 設定内容 | +| --- | --- | +| **Scheduled** | スケジュール、プロンプト、実行ターゲット、モデル、必要に応じて作業ディレクトリ。 | +| **Slack** | チャンネル、メッセージソース、プロンプト、実行ターゲット、公開範囲、キーワード、モデル。 | +| **GitHub** | リポジトリ、イベント、workflow 設定、テンプレート固有のオプション。 | + +### 自動化を管理する + +自動化の行を選択すると詳細ビューが開きます。トリガー種別と権限に応じて、今すぐ実行、一時停止、再開、共有、フォーク、名前変更、編集、削除ができます。 + +## 自動化の設定 + +### トリガー種別 + +トリガー種別は、自動化を開始する条件と、Droid が受け取るコンテキストを定義します。 + +- **Scheduled automations** は、自然言語または cron のスケジュールでプロンプトを実行します。 +- **Slack automations** は、設定した Slack チャンネルからセッションを開始します。メッセージソースやキーワードでトリガーを制限できます。 +- **GitHub automations** は、GitHub workflow ファイルを通じて実行され、pull request、push、コメント、ラベル、check などのイベントに応答できます。 + +### 実行ターゲット、ID、モデル + +実行設定を使うと、自動化を Droid がどのように実行するかを制御できます。 + +- **Run as**: 自動化を実行するユーザーまたはサービスアカウント。 +- **Run on**: Droid が実行されるコンピューター。 +- **Model**: 自動化の実行に使用するモデル。 + +共有のチームワークフローでは、実行を安定した ID と環境で維持するために、[サービスアカウント](/jp/enterprise/service-accounts) と [Droid Computers](/jp/cli/features/droid-computers) を使用します。 + +### 公開範囲と所有者 + +- **Private** 自動化は所有者のみが閲覧できます。 +- **Shared** 自動化は組織内に公開されます。 +- 所有者は自動化の編集、共有、一時停止、再開、削除ができます。 +- 所有者以外は、自分用のコピーが必要な場合に共有自動化をフォークできます。 + +### 実行履歴とダッシュボード + +自動化の詳細ビューには最近の実行とステータスが表示されます。Scheduled 自動化では、表、グラフ、要約など、自動化が生成した視覚的なダッシュボード出力も表示できます。 diff --git a/docs/jp/web/factory-router.mdx b/docs/jp/web/factory-router.mdx index fa12a7f64..036243a86 100644 --- a/docs/jp/web/factory-router.mdx +++ b/docs/jp/web/factory-router.mdx @@ -5,10 +5,6 @@ description: 各タスクに最適なモデルを自動的に選択します。 keywords: ['自動モデルルーティング', 'Factory Router', 'モデルルーティング', 'モデル', 'エンタープライズ制御', 'コスト削減'] --- - - Factory Routerは現在 **Research Preview** です。 - - Factory Routerは、各Droidタスクに最適なモデルを自動的に選択します。セッションごとに単一のモデルを毎回手動で選ぶ代わりに、Factory Routerがタスクを評価し、品質、レイテンシ、コストのバランスが最もよいモデルに作業をルーティングします。 Factory RouterはFactory CLIとFactory Appで利用でき、他のモデルと同じエンタープライズ制御で動作します。 @@ -19,7 +15,7 @@ Factory Routerは、ワークフローごとにモデル選択を手動で切り - Factoryの評価では、Factory Routerは難易度の高いベンチマークでフロンティア級の性能を維持しながら、常に最上位モデルを使用する場合と比べてコストをおよそ **20〜25%** 削減しました。 + Factory Routerは本番環境において、同じワークロードを最上位モデルの料金で換算した場合と比べて、Factoryの評価でフロンティア級の性能を維持しながら、集計ベースで **43%** のコスト削減を実現します。 Droidは定型的なステップを高速または低コストのモデルにルーティングし、より深い推論が必要な作業には高性能なモデルを確保できます。 @@ -31,7 +27,7 @@ Factory Routerは、ワークフローごとにモデル選択を手動で切り ## 提供状況 -Factory Routerは、一部のお客様向けにFactory CLIとFactory Appのモデルセレクターで **Factory Router (Research Preview)** として利用できます。 +Factory Routerは、設定不要でFactory CLIとFactory Appのモデルセレクターから一般提供されています。 ## エンタープライズ制御 @@ -55,4 +51,4 @@ Factory Routerは現在、他のモデルと同様に有効化または無効化 ### Factory Routerのコスト面での利点は何ですか？ -Factory Routerはフロンティア級の性能を維持しながら、常に最上位モデルを使用する場合と比べてコストをおよそ20〜25%削減します。 +本番環境では、請求対象の利用量を同じワークロードの最上位モデル料金と比較すると、総コストは43%低くなります。中央値のセッションコストは81%低く、61%のセッションでは少なくとも80%安価です。その間も、Factory Routerは一貫してフロンティア級の性能を維持します。 diff --git a/docs/jp/web/missions.mdx b/docs/jp/web/missions.mdx index 39c7b225e..caa2c1987 100644 --- a/docs/jp/web/missions.mdx +++ b/docs/jp/web/missions.mdx @@ -4,10 +4,6 @@ description: Factory MissionsをDesktopおよびWebアプリで使って、構 keywords: ['factory missions', 'missions', 'web', 'desktop', 'orchestration'] --- - - Desktop/WebでのMissionsは現在 **Research Preview** です。 - -
Mission Controlのオーケストレーション画面 @@ -18,7 +14,7 @@ keywords: ['factory missions', 'missions', 'web', 'desktop', 'orchestration'] Missions は CLI から実行することもできますが、Factory Desktop と Web アプリケーションでは、視覚的で情報量の多い Mission Control ダッシュボードを利用できます。このインターフェースは、あなたがプロジェクトマネージャーとして動けるよう設計されており、オーケストレーター、ワーカー、バリデーターが何をしているのかをより明確に把握できます。 -## Missionsの開始と再開 +## ミッションの開始と再開 - **新しいミッションを開始:** 新しいセッションを作成するときに **Mission mode** を選ぶか、Mission Control ページから直接ミッションを開始できます。 - **過去のミッションを続行:** [Mission Control タブ](https://app.factory.ai/missions)に移動すると、過去のミッションを見つけて現在の状態を確認し、中断した場所からそのまま実行を再開できます。 @@ -36,8 +32,8 @@ Mission Control ダッシュボードでは、マルチエージェントのワ ## 関連項目 -- [Factory Missions 概要](/jp/features/missions/overview) -- コンセプトと動作の仕組み +- [Factory Missions 概要](/jp/features/missions/overview) -- コンセプトと Factory Missions の動作の仕組み - [計画と検証](/jp/features/missions/planning) -- 事前プランを正しく組み立てる - [CLIでの実行](/jp/cli/features/missions/running-cli) -- ターミナルから実行を監視・操作する -- [トラブルシューティング](/jp/features/missions/troubleshooting) -- 停止したミッション、詰まったワーカー、ブロックされたマイルストーンからの復旧 +- [トラブルシューティング](/jp/features/missions/troubleshooting) -- 停止したミッション、詰まったワーカー、ブロックされたマイルストーンから復旧する - [設定とリファレンス](/jp/features/missions/reference) -- ヘッドレス実行、設定、組織ポリシー diff --git a/docs/jp/web/software-factory.mdx b/docs/jp/web/software-factory.mdx new file mode 100644 index 000000000..f6fb246b7 --- /dev/null +++ b/docs/jp/web/software-factory.mdx @@ -0,0 +1,88 @@ +--- +title: Software Factory +description: Software Factory を使って、ソフトウェアデリバリーライフサイクル全体をカバーする自動化を管理します。 +keywords: ['software factory', 'automations', 'sdlc', 'triage', 'code review', 'qa', 'autowiki', 'incident response'] +--- + +Software Factory は、インテークとトリアージから、計画、実行、検証、リリース、監視、継続的な自動化まで、ソフトウェア開発ライフサイクル全体で AI エージェントをつなぐ 24 時間 365 日稼働の自律システムです。 + + + Software Factory はプライベートプレビュー中です。アクセスをリクエストするには、[factory.ai/contact](https://factory.ai/contact) のフォームに入力するか、Factory のアカウントチームにお問い合わせください。 + + + + Software Factory の概要ダッシュボード + + +## Software Factory とは + +Factory App の Software Factory では、チームはライブメトリクス、接続済みの連携、リポジトリカバレッジ、ステージの健全性、永続的な自動化を 1 か所で追跡できます。 + +| ステージ | 対象 | +| --- | --- | +| **Triage** | 受信した作業を分類し、重複を減らし、項目を振り分けます。 | +| **Code-gen** | Slack や課題管理ツールからの依頼を実装セッションにつなげます。 | +| **Validate** | マージ前にコードレビュー、セキュリティレビュー、QA を実行します。 | +| **Release** | デプロイのゲートを追跡し、利用可能になったワークフローを使ってリリースを進めます。 | +| **Document** | AutoWiki でリポジトリの知識を最新に保ちます。 | +| **Monitor** | インシデント、アラート、エージェントの有効性をエンジニアリング作業へ結び付けます。 | + +### Software Factory を使うタイミング + +Software Factory は、ソフトウェアデリバリーライフサイクル全体におけるプロダクトの健全性を一元的に把握するために使用します。 + +- どの SDLC ステージにすでに自動化のカバレッジがあるか。 +- どのリポジトリ、連携、ステージでセットアップが必要か。 +- レビュー、QA、ドキュメント、トリアージ、インシデント対応のワークフローが健全か。 +- Factory が時間の経過とともにどれだけの作業を処理したか。 + +## SDLC 全体のカバレッジを管理する + +[**Software Factory**](https://app.factory.ai/software-factory) を開くと、デリバリーライフサイクルを自動化カバレッジマップとして確認できます。各ステージには、すでに接続されているもの、健全なもの、次にカバレッジを追加すべき場所が表示されます。 + +ダッシュボードでは次のことができます。 + +- 期間を切り替える。 +- インパクトメトリクスとステージの健全性を確認する。 +- GitHub、Slack、Linear、GitLab などの連携で絞り込む。 +- ステージを開いて、テンプレート、自動化、カバーされているリポジトリを確認する。 +- ステージ詳細ページまたは [Automations](/jp/web/automations) ページから不足している自動化を作成する。 + +リポジトリに紐づくステージではリポジトリカバレッジが表示されるため、**Code Review**、**QA**、**Security Audit**、**AutoWiki** などのワークフローがどのリポジトリをカバーしているか確認できます。 + +| ステージ | テンプレートとセットアップ | 表示されるカバレッジ | +| --- | --- | --- | +| **Triage** | Triage | インテーク自動化のカバレッジ | +| **Code-gen** | Slack と Linear からの委任 | 連携のカバレッジ | +| **Validate** | Code Review、QA、Security Audit | リポジトリのカバレッジ | +| **Release** | 利用可能な Release ワークフロー | リリースステータス | +| **Document** | AutoWiki | リポジトリのカバレッジ | +| **Monitor** | Incident Response、Agent Effectiveness | インシデントと効率性のカバレッジ | + +## メトリクスとカバレッジ + +### 自動化メトリクス + +Software Factory では、次のような指標で SDLC 全体における自動化の効果をリアルタイムに確認できます。 + + + Software Factory の自動化メトリクス + + +| 指標 | 意味 | +| --- | --- | +| **Tickets Triaged** | トリアージワークフローによって分類、重複排除、振り分けされたチケット数。 | +| **PR Validations** | PR に対して実行された QA とコードレビューのチェック数。 | +| **PRs Merged** | 選択した期間内にマージされた PR 数。 | +| **Incidents Processed** | インシデント対応ワークフローが処理したインシデント、エラー、アラート数。 | + +これらのメトリクスを使うと、自動化がどこで作業を前に進めているか、どこでチームにさらなるカバレッジが必要かを把握できます。 + +### 健全性とカバレッジ + +健全性とカバレッジを使うと、Software Factory の実行準備が整っている場所と、セットアップが不足している場所を見つけられます。 + +- **Health** は、ステージが必要な連携と自動化を備えているかを示します。 +- **Coverage** は、それらの自動化がどこに適用されるかを示します。たとえば **Validate** や **Document** がどのリポジトリをカバーしているかなどです。 + +不足しているものがあれば、ステージを開いて連携を接続し、リポジトリやチャンネルを追加するか、想定されている自動化を作成してください。