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:
40
docs/ja-JP/rules/php/coding-style.md
Normal file
40
docs/ja-JP/rules/php/coding-style.md
Normal file
@@ -0,0 +1,40 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.php"
|
||||
- "**/composer.json"
|
||||
---
|
||||
# PHP コーディングスタイル
|
||||
|
||||
> このファイルは [common/coding-style.md](../common/coding-style.md) を PHP 固有のコンテンツで拡張します。
|
||||
|
||||
## 標準
|
||||
|
||||
- **PSR-12** のフォーマットと命名規則に従う。
|
||||
- アプリケーションコードでは `declare(strict_types=1);` を優先する。
|
||||
- 新しいコードが許す限り、スカラー型ヒント、戻り値の型、型付きプロパティをあらゆる箇所で使用する。
|
||||
|
||||
## 不変性
|
||||
|
||||
- サービス境界を越えるデータには不変の DTO と値オブジェクトを優先する。
|
||||
- 可能な場合はリクエスト/レスポンスペイロードに `readonly` プロパティまたは不変コンストラクタを使用する。
|
||||
- 単純なマップには配列を使用する; ビジネスクリティカルな構造は明示的なクラスに昇格させる。
|
||||
|
||||
## フォーマット
|
||||
|
||||
- フォーマットには **PHP-CS-Fixer** または **Laravel Pint** を使用する。
|
||||
- 静的解析には **PHPStan** または **Psalm** を使用する。
|
||||
- Composer スクリプトをチェックインし、ローカルと CI で同じコマンドが実行されるようにする。
|
||||
|
||||
## インポート
|
||||
|
||||
- 参照されるすべてのクラス、インターフェース、トレイトに `use` 文を追加する。
|
||||
- プロジェクトが明示的に完全修飾名を好む場合を除き、グローバル名前空間への依存を避ける。
|
||||
|
||||
## エラーハンドリング
|
||||
|
||||
- 例外的な状態には例外をスローする; 新しいコードでは隠れたエラーチャネルとして `false`/`null` を返すことを避ける。
|
||||
- フレームワーク/リクエスト入力をドメインロジックに到達する前に検証済み DTO に変換する。
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `backend-patterns` でより広範なサービス/リポジトリの階層化ガイダンスを参照してください。
|
||||
24
docs/ja-JP/rules/php/hooks.md
Normal file
24
docs/ja-JP/rules/php/hooks.md
Normal file
@@ -0,0 +1,24 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.php"
|
||||
- "**/composer.json"
|
||||
- "**/phpstan.neon"
|
||||
- "**/phpstan.neon.dist"
|
||||
- "**/psalm.xml"
|
||||
---
|
||||
# PHP フック
|
||||
|
||||
> このファイルは [common/hooks.md](../common/hooks.md) を PHP 固有のコンテンツで拡張します。
|
||||
|
||||
## PostToolUse フック
|
||||
|
||||
`~/.claude/settings.json` で設定:
|
||||
|
||||
- **Pint / PHP-CS-Fixer**: 編集された `.php` ファイルを自動フォーマット。
|
||||
- **PHPStan / Psalm**: 型付きコードベースで PHP 編集後に静的解析を実行。
|
||||
- **PHPUnit / Pest**: 編集が動作に影響する場合、対象ファイルやモジュールのテストを実行。
|
||||
|
||||
## 警告
|
||||
|
||||
- 編集されたファイルに残された `var_dump`、`dd`、`dump`、`die()` について警告する。
|
||||
- 編集された PHP ファイルが生 SQL を追加したり CSRF/セッション保護を無効化している場合に警告する。
|
||||
33
docs/ja-JP/rules/php/patterns.md
Normal file
33
docs/ja-JP/rules/php/patterns.md
Normal file
@@ -0,0 +1,33 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.php"
|
||||
- "**/composer.json"
|
||||
---
|
||||
# PHP パターン
|
||||
|
||||
> このファイルは [common/patterns.md](../common/patterns.md) を PHP 固有のコンテンツで拡張します。
|
||||
|
||||
## 薄いコントローラ、明示的なサービス
|
||||
|
||||
- コントローラはトランスポートに集中する: 認証、バリデーション、シリアライゼーション、ステータスコード。
|
||||
- ビジネスルールは HTTP ブートストラップなしでテストしやすいアプリケーション/ドメインサービスに移動する。
|
||||
|
||||
## DTO と値オブジェクト
|
||||
|
||||
- 形状の重い連想配列をリクエスト、コマンド、外部 API ペイロード用の DTO に置き換える。
|
||||
- 金額、識別子、日付範囲、その他の制約のある概念には値オブジェクトを使用する。
|
||||
|
||||
## 依存性注入
|
||||
|
||||
- フレームワークのグローバルではなく、インターフェースまたは狭いサービス契約に依存する。
|
||||
- サービスロケータ検索なしでテスト可能になるよう、コンストラクタ経由で協力オブジェクトを渡す。
|
||||
|
||||
## 境界
|
||||
|
||||
- モデル層が永続化以上のことをしている場合、ORM モデルをドメイン判断から分離する。
|
||||
- サードパーティ SDK を小さなアダプタでラップし、コードベースの残りが彼らの契約ではなく自身の契約に依存するようにする。
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `api-design` でエンドポイントの規約とレスポンス形状のガイダンスを参照してください。
|
||||
スキル: `laravel-patterns` で Laravel 固有のアーキテクチャガイダンスを参照してください。
|
||||
37
docs/ja-JP/rules/php/security.md
Normal file
37
docs/ja-JP/rules/php/security.md
Normal file
@@ -0,0 +1,37 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.php"
|
||||
- "**/composer.lock"
|
||||
- "**/composer.json"
|
||||
---
|
||||
# PHP セキュリティ
|
||||
|
||||
> このファイルは [common/security.md](../common/security.md) を PHP 固有のコンテンツで拡張します。
|
||||
|
||||
## 入力と出力
|
||||
|
||||
- フレームワーク境界でリクエスト入力を検証する(`FormRequest`、Symfony Validator、または明示的な DTO バリデーション)。
|
||||
- テンプレートではデフォルトで出力をエスケープする; 生の HTML レンダリングは正当化が必要な例外として扱う。
|
||||
- バリデーションなしにクエリパラメータ、Cookie、ヘッダー、アップロードされたファイルのメタデータを信頼しない。
|
||||
|
||||
## データベースの安全性
|
||||
|
||||
- すべての動的クエリにプリペアドステートメント(`PDO`、Doctrine、Eloquent クエリビルダ)を使用する。
|
||||
- コントローラ/ビューでの文字列構築 SQL を避ける。
|
||||
- ORM のマスアサインメントを慎重にスコープし、書き込み可能なフィールドをホワイトリストにする。
|
||||
|
||||
## シークレットと依存関係
|
||||
|
||||
- 環境変数またはシークレットマネージャからシークレットをロードする、コミットされた設定ファイルからは読み込まない。
|
||||
- CI で `composer audit` を実行し、依存関係追加前に新しいパッケージメンテナーの信頼性を確認する。
|
||||
- メジャーバージョンは意図的に固定し、放棄されたパッケージは速やかに削除する。
|
||||
|
||||
## 認証とセッションの安全性
|
||||
|
||||
- パスワード保存には `password_hash()` / `password_verify()` を使用する。
|
||||
- 認証と権限変更後にセッション識別子を再生成する。
|
||||
- 状態変更を伴う Web リクエストに CSRF 保護を強制する。
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `laravel-security` で Laravel 固有のセキュリティガイダンスを参照してください。
|
||||
39
docs/ja-JP/rules/php/testing.md
Normal file
39
docs/ja-JP/rules/php/testing.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.php"
|
||||
- "**/phpunit.xml"
|
||||
- "**/phpunit.xml.dist"
|
||||
- "**/composer.json"
|
||||
---
|
||||
# PHP テスト
|
||||
|
||||
> このファイルは [common/testing.md](../common/testing.md) を PHP 固有のコンテンツで拡張します。
|
||||
|
||||
## フレームワーク
|
||||
|
||||
デフォルトのテストフレームワークとして **PHPUnit** を使用する。プロジェクトに **Pest** が設定されている場合、新しいテストには Pest を優先し、フレームワークの混在を避ける。
|
||||
|
||||
## カバレッジ
|
||||
|
||||
```bash
|
||||
vendor/bin/phpunit --coverage-text
|
||||
# または
|
||||
vendor/bin/pest --coverage
|
||||
```
|
||||
|
||||
CI では **pcov** または **Xdebug** を優先し、カバレッジ閾値は暗黙知ではなく CI で管理する。
|
||||
|
||||
## テストの構成
|
||||
|
||||
- 高速なユニットテストとフレームワーク/データベース統合テストを分離する。
|
||||
- フィクスチャには大きな手書き配列ではなくファクトリ/ビルダーを使用する。
|
||||
- HTTP/コントローラテストはトランスポートとバリデーションに集中する; ビジネスルールはサービスレベルのテストに移動する。
|
||||
|
||||
## Inertia
|
||||
|
||||
プロジェクトが Inertia.js を使用している場合、生の JSON アサーションではなく `AssertableInertia` 付きの `assertInertia` でコンポーネント名とプロップスを検証することを優先する。
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `tdd-workflow` でリポジトリ全体の RED -> GREEN -> REFACTOR ループを参照してください。
|
||||
スキル: `laravel-tdd` で Laravel 固有のテストパターン(PHPUnit と Pest)を参照してください。
|
||||
Reference in New Issue
Block a user