mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 14:53:05 +08:00
docs: add native Japanese translation of ECC documentation (ja-JP)
Translate everything-claude-code repository to Japanese including: - 17 root documentation files - 60 agent documentation files - 80 command documentation files - 99 rule files across 18 language directories (common, angular, arkts, cpp, csharp, dart, fsharp, golang, java, kotlin, perl, php, python, ruby, rust, swift, typescript, web) - 199 skill documentation files Total: 455 files translated to Japanese with: - Consistent terminology glossary applied throughout - YAML field names preserved in English (name, description, etc.) - Code blocks and examples untouched (comments translated) - Markdown structure and relative links preserved - Professional translation maintaining technical accuracy This translation expands ECC accessibility to Japanese-speaking developers and teams. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
170
docs/ja-JP/AGENTS.md
Normal file
170
docs/ja-JP/AGENTS.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# Everything Claude Code (ECC) — エージェント指示書
|
||||
|
||||
これは60の専門エージェント、228のスキル、75のコマンド、自動化フックワークフローを提供する**プロダクション対応のAIコーディングプラグイン**です。
|
||||
|
||||
**バージョン:** 2.0.0-rc.1
|
||||
|
||||
## コア原則
|
||||
|
||||
1. **エージェントファースト** — ドメインタスクは専門エージェントに委任する
|
||||
2. **テスト駆動** — 実装前にテストを書き、80%以上のカバレッジを必須とする
|
||||
3. **セキュリティファースト** — セキュリティに妥協せず、すべての入力を検証する
|
||||
4. **イミュータビリティ** — 常に新しいオブジェクトを生成し、既存のものを変更しない
|
||||
5. **実行前に計画** — 複雑な機能はコードを書く前に計画する
|
||||
|
||||
## 利用可能なエージェント
|
||||
|
||||
| エージェント | 目的 | 使用タイミング |
|
||||
|-------------|------|---------------|
|
||||
| planner | 実装計画 | 複雑な機能、リファクタリング |
|
||||
| architect | システム設計とスケーラビリティ | アーキテクチャの意思決定 |
|
||||
| tdd-guide | テスト駆動開発 | 新機能、バグ修正 |
|
||||
| code-reviewer | コード品質と保守性 | コードの作成/変更後 |
|
||||
| security-reviewer | 脆弱性検出 | コミット前、機密コード |
|
||||
| build-error-resolver | ビルド/型エラーの修正 | ビルド失敗時 |
|
||||
| e2e-runner | E2E Playwrightテスト | クリティカルなユーザーフロー |
|
||||
| refactor-cleaner | デッドコードのクリーンアップ | コードメンテナンス |
|
||||
| doc-updater | ドキュメントとコードマップ | ドキュメント更新 |
|
||||
| cpp-reviewer | C/C++コードレビュー | C/C++プロジェクト |
|
||||
| cpp-build-resolver | C/C++ビルドエラー | C/C++ビルド失敗 |
|
||||
| fsharp-reviewer | F#関数型コードレビュー | F#プロジェクト |
|
||||
| docs-lookup | Context7経由のドキュメント検索 | API/ドキュメントの質問 |
|
||||
| go-reviewer | Goコードレビュー | Goプロジェクト |
|
||||
| go-build-resolver | Goビルドエラー | Goビルド失敗 |
|
||||
| kotlin-reviewer | Kotlinコードレビュー | Kotlin/Android/KMPプロジェクト |
|
||||
| kotlin-build-resolver | Kotlin/Gradleビルドエラー | Kotlinビルド失敗 |
|
||||
| database-reviewer | PostgreSQL/Supabaseスペシャリスト | スキーマ設計、クエリ最適化 |
|
||||
| python-reviewer | Pythonコードレビュー | Pythonプロジェクト |
|
||||
| django-reviewer | Djangoコードレビュー | Djangoアプリ、DRF API、ORM、マイグレーション |
|
||||
| django-build-resolver | Djangoビルド、マイグレーション、セットアップエラー | Django起動、依存関係、マイグレーション、collectstatic失敗 |
|
||||
| java-reviewer | JavaとSpring Bootコードレビュー | Java/Spring Bootプロジェクト |
|
||||
| java-build-resolver | Java/Maven/Gradleビルドエラー | Javaビルド失敗 |
|
||||
| loop-operator | 自律ループ実行 | ループの安全な実行、停滞の監視、介入 |
|
||||
| harness-optimizer | ハーネス設定チューニング | 信頼性、コスト、スループット |
|
||||
| rust-reviewer | Rustコードレビュー | Rustプロジェクト |
|
||||
| rust-build-resolver | Rustビルドエラー | Rustビルド失敗 |
|
||||
| pytorch-build-resolver | PyTorchランタイム/CUDA/トレーニングエラー | PyTorchビルド/トレーニング失敗 |
|
||||
| mle-reviewer | 本番MLパイプラインレビュー | MLパイプライン、評価、サービング、モニタリング、ロールバック |
|
||||
| typescript-reviewer | TypeScript/JavaScriptコードレビュー | TypeScript/JavaScriptプロジェクト |
|
||||
|
||||
## エージェントオーケストレーション
|
||||
|
||||
ユーザーのプロンプトなしで積極的にエージェントを使用する:
|
||||
- 複雑な機能リクエスト → **planner**
|
||||
- コードの作成/変更直後 → **code-reviewer**
|
||||
- バグ修正または新機能 → **tdd-guide**
|
||||
- アーキテクチャの意思決定 → **architect**
|
||||
- セキュリティに関わるコード → **security-reviewer**
|
||||
- 自律ループ / ループ監視 → **loop-operator**
|
||||
- ハーネス設定の信頼性とコスト → **harness-optimizer**
|
||||
|
||||
独立した操作には並列実行を使用する — 複数のエージェントを同時に起動する。
|
||||
|
||||
## セキュリティガイドライン
|
||||
|
||||
**コミット前に必ず確認:**
|
||||
- ハードコードされたシークレットがないこと(APIキー、パスワード、トークン)
|
||||
- すべてのユーザー入力が検証されていること
|
||||
- SQLインジェクション対策(パラメータ化クエリ)
|
||||
- XSS対策(HTMLのサニタイズ)
|
||||
- CSRF保護が有効であること
|
||||
- 認証/認可が検証されていること
|
||||
- すべてのエンドポイントにレート制限があること
|
||||
- エラーメッセージが機密データを漏洩しないこと
|
||||
|
||||
**シークレット管理:** シークレットを絶対にハードコードしない。環境変数またはシークレットマネージャーを使用する。起動時に必要なシークレットを検証する。漏洩したシークレットは直ちにローテーションする。
|
||||
|
||||
**セキュリティ問題が見つかった場合:** 停止 → security-reviewerエージェントを使用 → CRITICALな問題を修正 → 漏洩したシークレットをローテーション → 類似の問題がないかコードベースをレビュー。
|
||||
|
||||
## コーディングスタイル
|
||||
|
||||
**イミュータビリティ(必須):** 常に新しいオブジェクトを生成し、変更しない。変更を適用した新しいコピーを返す。
|
||||
|
||||
**ファイル構成:** 少数の大きなファイルより、多数の小さなファイルを優先。200〜400行が標準、最大800行。型ではなく機能/ドメインで整理する。高凝集、低結合。
|
||||
|
||||
**エラーハンドリング:** あらゆるレベルでエラーを処理する。UIコードではユーザーフレンドリーなメッセージを提供する。サーバーサイドでは詳細なコンテキストをログに記録する。エラーを暗黙的に握りつぶさない。
|
||||
|
||||
**入力バリデーション:** システム境界ですべてのユーザー入力を検証する。スキーマベースのバリデーションを使用する。明確なメッセージで早期に失敗させる。外部データを決して信頼しない。
|
||||
|
||||
**コード品質チェックリスト:**
|
||||
- 関数は小さく(<50行)、ファイルは焦点を絞る(<800行)
|
||||
- 深いネストなし(>4レベル)
|
||||
- 適切なエラーハンドリング、ハードコードされた値なし
|
||||
- 読みやすく、適切に命名された識別子
|
||||
|
||||
## テスト要件
|
||||
|
||||
**最低カバレッジ:80%**
|
||||
|
||||
テストの種類(すべて必須):
|
||||
1. **ユニットテスト** — 個々の関数、ユーティリティ、コンポーネント
|
||||
2. **統合テスト** — APIエンドポイント、データベース操作
|
||||
3. **E2Eテスト** — クリティカルなユーザーフロー
|
||||
|
||||
**TDDワークフロー(必須):**
|
||||
1. テストを先に書く(RED) — テストは失敗するべき
|
||||
2. 最小限の実装を書く(GREEN) — テストは合格するべき
|
||||
3. リファクタリング(IMPROVE) — カバレッジ80%以上を確認
|
||||
|
||||
失敗のトラブルシューティング:テストの分離を確認 → モックを検証 → 実装を修正(テストが間違っている場合を除き、テストではなく実装を修正)。
|
||||
|
||||
## 開発ワークフロー
|
||||
|
||||
1. **計画** — plannerエージェントを使用、依存関係とリスクを特定、フェーズに分割
|
||||
2. **TDD** — tdd-guideエージェントを使用、テストを先に書く、実装、リファクタリング
|
||||
3. **レビュー** — code-reviewerエージェントを即座に使用、CRITICAL/HIGH問題に対処
|
||||
4. **知識を適切な場所に記録する**
|
||||
- 個人的なデバッグメモ、好み、一時的なコンテキスト → オートメモリ
|
||||
- チーム/プロジェクトの知識(アーキテクチャ決定、API変更、ランブック) → プロジェクトの既存ドキュメント構造
|
||||
- 現在のタスクで関連するドキュメントやコードコメントが既に生成されている場合、同じ情報を別の場所に複製しない
|
||||
- 明確なプロジェクトドキュメントの場所がない場合、新しいトップレベルファイルを作成する前に確認する
|
||||
5. **コミット** — Conventional Commits形式、包括的なPRサマリー
|
||||
|
||||
## ワークフローサーフェスポリシー
|
||||
|
||||
- `skills/` が正規のワークフローサーフェスです。
|
||||
- 新しいワークフローの貢献はまず `skills/` に配置するべきです。
|
||||
- `commands/` はレガシーなスラッシュエントリー互換サーフェスであり、マイグレーションまたはクロスハーネスのパリティのためにシムが必要な場合にのみ追加・更新するべきです。
|
||||
|
||||
## Gitワークフロー
|
||||
|
||||
**コミット形式:** `<type>: <description>` — タイプ:feat, fix, refactor, docs, test, chore, perf, ci
|
||||
|
||||
**PRワークフロー:** 完全なコミット履歴を分析 → 包括的なサマリーを作成 → テストプランを含める → `-u`フラグ付きでプッシュ。
|
||||
|
||||
## アーキテクチャパターン
|
||||
|
||||
**APIレスポンス形式:** 成功インジケーター、データペイロード、エラーメッセージ、ページネーションメタデータを含む一貫したエンベロープ。
|
||||
|
||||
**リポジトリパターン:** 標準インターフェース(findAll, findById, create, update, delete)の背後にデータアクセスをカプセル化する。ビジネスロジックはストレージメカニズムではなく、抽象インターフェースに依存する。
|
||||
|
||||
**スケルトンプロジェクト:** 実績あるテンプレートを検索し、並列エージェント(セキュリティ、拡張性、関連性)で評価し、最適なものをクローンし、実績ある構造内で反復する。
|
||||
|
||||
## パフォーマンス
|
||||
|
||||
**コンテキスト管理:** 大規模なリファクタリングやマルチファイル機能では、コンテキストウィンドウの最後の20%を避ける。低感度のタスク(単一の編集、ドキュメント、簡単な修正)はより高い使用率を許容する。
|
||||
|
||||
**ビルドトラブルシューティング:** build-error-resolverエージェントを使用 → エラーを分析 → 段階的に修正 → 各修正後に検証。
|
||||
|
||||
## プロジェクト構造
|
||||
|
||||
```
|
||||
agents/ — 60の専門サブエージェント
|
||||
skills/ — 228のワークフロースキルとドメイン知識
|
||||
commands/ — 75のスラッシュコマンド
|
||||
hooks/ — トリガーベースの自動化
|
||||
rules/ — 常に従うべきガイドライン(共通 + 言語別)
|
||||
scripts/ — クロスプラットフォームNode.jsユーティリティ
|
||||
mcp-configs/ — 14のMCPサーバー設定
|
||||
tests/ — テストスイート
|
||||
```
|
||||
|
||||
`commands/` は互換性のためにリポジトリに残っていますが、長期的な方向性はスキルファーストです。
|
||||
|
||||
## 成功指標
|
||||
|
||||
- すべてのテストが80%以上のカバレッジで合格
|
||||
- セキュリティ脆弱性なし
|
||||
- コードが読みやすく保守しやすい
|
||||
- パフォーマンスが許容範囲内
|
||||
- ユーザー要件が満たされている
|
||||
Reference in New Issue
Block a user