コントリビューティング

Language: English | 日本語 Last updated: 2026-04-18 EN canonical: 2026-04-18 of wiki/en/Contributing.md Audience: エージェント開発者

このページはAphelionへの貢献方法をカバーします：エージェントの追加・変更、ルールの更新、Wikiのメンテナンス、プラットフォームジェネレーターの実行。プルリクエストを開く前にこのページを読んでください。

貢献の種類

種類	必要な変更
新しいエージェント	`.claude/agents/{name}.md` + Agents-Reference（en+ja）+ generate.mjs（新しいエージェントの場合）
エージェントの変更	`.claude/agents/{name}.md` + Agents-Referenceのエントリ（en+ja）
新しいルール	`.claude/rules/{name}.md` + Rules-Reference（en+ja）
ルールの変更	`.claude/rules/{name}.md` + Rules-Referenceのエントリ（en+ja）
オーケストレータールールの変更	`.claude/orchestrator-rules.md` + Architecture.md / Triage-System.md（en+ja）
Wikiページの更新	`wiki/en/{page}.md` + `wiki/ja/{page}.md`（同一PR）
プラットフォームジェネレーターの変更	`scripts/generate.mjs` + `platforms/`の再生成

新しいエージェントの追加

.claude/agents/{name}.mdにエージェント定義ファイルを作成します。

既存エージェントで使用されている標準フロントマター形式に従います：
```
---
name: {agent-name}
description: |
  {オーケストレーター検出用の1行説明}
tools: Read, Write, Edit, Bash, Glob, Grep
---
```
以下のセクションを含めてください：Mission、Inputs、Workflow、Outputs、AGENT_RESULT（全フィールド）、NEXT条件。
Agents-Referenceを更新します（wiki/en/Agents-Reference.mdとwiki/ja/Agents-Reference.md）。標準スキーマ（正規、ドメイン、責務、入力、出力、AGENT_RESTULTフィールド、NEXT条件）に従って新しいエントリを追加します。適切なドメインセクションにエントリを追加してください。
エージェントをスタンドアロンスラッシュコマンドとして起動可能にする場合、.claude/commands/{name}.mdに対応するコマンドファイルを追加します。
エージェントが新しいフローオーケストレーターの場合、新しいエージェントをトリアージまたはフェーズシーケンスに含めるよう.claude/orchestrator-rules.mdを更新します。
プラットフォームファイルを再生成します：node scripts/generate.mjsを実行してplatforms/copilot/とplatforms/codex/を更新します。
Agents-Referenceの分割しきい値：エージェントの合計数が40を超える場合、またはAgents-Reference.md内のいずれかのセクションが300行を超える場合は、エージェントごとのwiki/en/agents/{name}.mdファイルへの分割とAgents-Reference.mdをリスト+リンクハブに変換することを検討してください。これは将来の決定事項です — まずissueを開いて議論してください。

既存エージェントの変更

.claude/agents/{name}.mdの正規ファイルを編集します。
wiki/en/Agents-Reference.mdとwiki/ja/Agents-Reference.mdの両方のAgents-Referenceエントリを更新して変更を反映させます。

Agents-Referenceの同期維持は必須です。Wikiエントリを更新せずにエージェント定義を更新すると、レビュアーが修正を要求します。
プラットフォームファイルを再生成します：node scripts/generate.mjsを実行して変更をplatforms/copilot/とplatforms/codex/に伝播させます。

ルールの更新

.claude/rules/{name}.mdの正規ファイルを編集します。
wiki/en/Rules-Reference.mdとwiki/ja/Rules-Reference.mdの両方のRules-Referenceエントリを更新します。
ルールの変更がオーケストレーターの動作に影響する場合、wiki/en/Architecture.mdとwiki/ja/Architecture.mdも更新します。
ルールがトリアージに影響する場合、wiki/en/Triage-System.mdとwiki/ja/Triage-System.mdも更新します。
ルールの変更がプラットフォーム生成ファイルに影響する場合（例：build-verification-commandsやlibrary-and-security-policy）、プラットフォームファイルを再生成します。

Wikiのメンテナンス

既存ページの編集

常にまず英語ページ（wiki/en/）を編集してください — それが正規ソースです。
英語ページの先頭の> Last updated:を更新します。
同一PRで対応する日本語ページを更新します。> EN canonical:を現在の日付に更新します。

新しいページの追加

標準フロントマターでwiki/en/{slug}.mdを作成します。
wiki/ja/{slug}.mdをEN canonical: {date} of wiki/en/{slug}.mdで作成します。
両方のページをwiki/en/Home.mdとwiki/ja/Home.mdの## Pagesセクションに追加します。
関連するページにRelated Pagesリンクを追加します。

未翻訳ページのフォールバック

新しい英語ページを追加するが同一PRで日本語翻訳を提供できない場合は、wiki/ja/{slug}.mdにスタブを配置してください：

> 本ページは英語版が先行しています。[English version](../en/{slug}.md) を参照してください。

30日以内に翻訳し、スタブのissueをフォローアップPRにリンクしてください。

READMEとWikiの棲み分け

README：エントリーポイントとクイックスタート。短くまとめてください — セットアップ、シナリオ、コマンドリファレンス。
Wiki：詳細リファレンス。エージェントスキーマ、ルール説明、プラットフォーム内部、トリアージロジック。
詳細なリファレンスコンテンツをREADMEに追加しないでください。クイックスタートコンテンツをwikiのHome.mdに追加しないでください。

バイリンガル同期ポリシー

Wikiは英語を正規とするバイリンガルです。以下のルールはPRレビューで強制されます：

必須：

wiki/en/{page}.mdを変更するPRはすべて、同一PRでwiki/ja/{page}.mdも更新しなければなりません。
英語のみのマージは禁止されています（軽微な修正を除く — 以下参照）。
英語ページが変更された場合、すべてのwiki/ja/ページの> EN canonical: {date}行を現在の日付に合わせて更新しなければなりません。

軽微な修正の例外：

英語のみのtypo修正とリンク切れ修正は、同一PRでの日本語同期なしにマージできます。
7日以内に日本語更新のためのフォローアップissueを開いてアサインしなければなりません。

レビュアーの責任：

レビュアーはwiki/en/とwiki/ja/の構造的な同等性（同じセクション、同じ見出し、一致するTOC）が維持されていることを確認します。

プラットフォームファイルの再生成

.claude/agents/、.claude/rules/、または.claude/orchestrator-rules.mdのファイルを変更するときは、プラットフォームファイルを再生成してください：

node scripts/generate.mjs

生成されたファイルを正規の変更とともにステージします：

git add .claude/agents/{name}.md platforms/copilot/agents/{name}.agent.md
git add platforms/codex/AGENTS.md

platforms/ファイルを直接編集しないでください。 それらは生成された成果物です。直接編集は次回のジェネレーター実行時に上書きされます。

プルリクエストチェックリスト

PRを開く前に確認してください：

正規ソース（.claude/agents/または.claude/rules/）を更新済み
変更がWikiコンテンツに影響する場合、wiki/en/ページを更新済み
同一PRでwiki/ja/ページを更新済み（バイリンガル同期）
変更したWikiページの> Last updated:行を更新済み
対応するwiki/ja/ページの> EN canonical:行を更新済み
エージェント/ルールが変更された場合、Agents-ReferenceまたはRules-Referenceのエントリを更新済み
正規が変更された場合、プラットフォームファイルを再生成済み（node scripts/generate.mjs）
生成されたplatforms/ファイルを正規の変更とともにステージ済み

正規ソース

.claude/agents/ — エージェント定義ファイル（正規）
.claude/rules/ — ルールファイル（正規）
scripts/generate.mjs — プラットフォームファイルジェネレーター
wiki/DESIGN.md — Wiki情報アーキテクチャ設計