777genius 95e0f34d31 docs(product-docs): add zh, es, ja, fr, de doc translations

Localize the VitePress docs into Simplified Chinese, Spanish, Japanese,
French and German (18 pages each), mirroring the existing en/ru structure.

- generate the 5 new locales in config.ts from a single strings table
  (nav, sidebar, search, footer, docFooter, outline, editLink) with
  locale-prefixed links
- rework DocsCardGrid from the binary isRu check to a per-locale map so
  the home cards render translated copy and prefixed links for every locale

2026-05-31 17:50:54 +03:00

5.3 KiB

Raw Blame History

title	description	lang
開発者ハブ – Agent Teams ドキュメント	Agent Teams のアーキテクチャ、ガードレール、デバッグ、MCP による拡張方法に関する、コントリビューターと開発者向けの入口です。	ja-JP

開発者ハブ

Agent Teams 自体を変更したい場合、チームの起動をデバッグしたい場合、または MCP ツールでランタイムを拡張したい場合は、このページを参照してください。以下のリンクは正規のリポジトリドキュメントを指しており、実装ルールが一箇所にまとまるようになっています。

はじめに

必要なこと	参照先
リポジトリの概要、スクリプト、ソースのセットアップ	README.md
エージェントのナビゲーションとアーキテクチャの索引	AGENTS.md
エージェントとコントリビューターのための作業規約	CLAUDE.md
厳格な実装ガードレール	AGENT_CRITICAL_GUARDRAILS.md
中規模および大規模な機能の構成	機能アーキテクチャ標準
起動、ブートストラップ、チームメイトのメッセージングのデバッグ	エージェントチームのデバッグ用ランブック
コントリビューションのプロセス	コントリビューションガイド
リリースノート / 変更履歴	RELEASE.md — CHANGELOG.md

ローカル開発の手順

通常の開発では、デスクトップ版の Electron アプリを実行します。

pnpm install
pnpm dev

ブラウザ/Web 版はデスクトップランタイムの代替にはなりません。デスクトップモードがサポートされたローカルの手順です。これには IPC、ターミナル、プロバイダー認証、チームのライフサイクル処理、起動診断、そして実際のチームで使われるランタイムブリッジが含まれているためです。

アーキテクチャのチェックポイント

機能を変更する前に、その境界を特定してください。

領域	想定される配置場所
中規模または大規模なプロダクト機能	`src/features/<feature-name>/`
Electron メインプロセスのオーケストレーション	`src/main/`
preload で安全な API サーフェス	`src/preload/`
レンダラーの UI とアプリの状態	`src/renderer/`
共有の型と純粋なヘルパー	`src/shared/`
Agent Teams ボードの MCP サーバー	`mcp-server/`
ボードのデータコントローラー	`agent-teams-controller/`

機能の構成については、src/features/recent-projects をリファレンスとなるスライスとして使用してください。プロセス間のコントラクトは明示的に保ち、機能の境界をまたいだ深いインポートは避けてください。

デバッグの手順

起動のハング、OpenCode の registered / bootstrap-unconfirmed 状態、チームメイトの返信の欠落、または不審なタスクログが発生した場合は、次の手順に従ってください。

デバッグ用ランブックから始めます。
~/.claude/teams/<team>/launch-failure-artifacts/latest.json にある最新のアーティファクトパックを確認します。
アーティファクトの manifest.json を開き、classification、ブートストラップのブレッドクラム、起動診断、メンバーのスポーン状態、伏字処理されたログの末尾を確認します。
スモークテストまたは失敗した起動が所有していると特定できるチーム、実行、ペイン、プロセスのみをクリーンアップします。

MCP 開発の手順

Agent Teams は、ボード操作のために agent-teams という名前の組み込み MCP サーバーを使用します。ユーザーおよびプロジェクトの MCP サーバーは、ランタイムに外部機能を追加できます。セットアップの例、.mcp.json の構造、ツール登録のガイダンスについては、MCP 連携を参照してください。

5.3 KiB Raw Blame History Unescape Escape