mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-05-18 14:53:05 +08:00

Files

Claude ec9ace9c54 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>

2026-05-17 02:31:40 -04:00

16 KiB

Raw Blame History

name, description, origin

name	description	origin
angular-developer	Angular コードを生成し、アーキテクチャガイダンスを提供します。プロジェクトの作成、コンポーネント、またはサービスを作成するとき、または反応性（シグナル、linkedSignal、リソース）、フォーム、依存性注入、ルーティング、SSR、アクセシビリティ（ARIA）、アニメーション、スタイリング（コンポーネントスタイル、Tailwind CSS）、テスト、または CLI ツール作成のベストプラクティスについてトリガーされます。	ECC

Angular 開発者ガイドライン

アクティブ化するとき

任意の Angular プロジェクトまたはコードベースで作業しているとき
新しい Angular プロジェクト、アプリケーション、またはライブラリを作成またはスキャフォールディングするとき
コンポーネント、サービス、ディレクティブ、パイプ、ガード、またはリソルバーを生成するとき
Angular シグナル、linkedSignal、または resource で反応性を実装するとき
Angular フォーム（シグナルフォーム、リアクティブフォーム、またはテンプレート駆動）で作業するとき
依存性注入、ルーティング、遅延ロード、またはルートガードをセットアップするとき
アクセシビリティ（ARIA）、アニメーション、またはコンポーネントスタイリングを追加するとき
Angular 固有のテスト（ユニット、コンポーネントハーネス、E2E）を作成またはデバッグするとき
Angular CLI ツール作成または Angular MCP サーバーを構成するとき

ガイダンスを提供する前に、常にプロジェクトの Angular バージョンを分析してください。ベストプラクティスと利用可能な機能はバージョン間で大きく異なる場合があります。Angular CLI を使用して新しいプロジェクトを作成する場合、ユーザーによるプロンプトがない限り、バージョンを指定しないでください。
コードを生成するときは、メンテナンス性とパフォーマンスのため、Angular のスタイルガイドと Angular のベストプラクティスに従ってください。Angular CLI を使用して、コンポーネント、サービス、ディレクティブ、パイプ、およびルートをスキャフォールディングして、一貫性を確保します。
コード生成を完了したら、ng build を実行してビルドエラーがないか確認してください。エラーがある場合は、エラーメッセージを分析して修正してから続行してください。生成されたコードが正しく機能することを確認するために、このステップをスキップしないことが重要です。

新しいプロジェクトの作成

ユーザーがガイドラインを提供しない場合は、新しい Angular プロジェクトを作成するときに、これらのデフォルトを使用してください。

ユーザーが別途指定しない限り、Angular の最新の安定バージョンを使用してください。
対象の Angular バージョンがシグナルフォームをサポートしている場合のみ、新しいプロジェクトではシグナルフォームを優先してください。詳細情報を確認してください。

ng new の実行ルール: 新しい Angular プロジェクトを作成するよう求められたとき、以下の厳密な手順に従って正しい実行コマンドを決定する必要があります。

ステップ 1: ユーザーが明示的にバージョンを指定しているか確認します。

IF ユーザーが特定のバージョンをリクエストしている場合（例：Angular 15）、ローカルインストールをバイパスして、厳密に npx を使用してください。
コマンド: npx @angular/cli@<requested_version> new <project-name>

ステップ 2: 既存の Angular インストールを確認します。

IF 特定のバージョンがリクエストされていない場合、ターミナルで ng version を実行して、Angular CLI がシステムに既にインストールされているかどうかを確認してください。
IF コマンドが成功して、インストール済みバージョンが返された場合は、ローカル/グローバルインストールを直接使用してください。
コマンド: ng new <project-name>

ステップ 3: 最新版へのフォールバック

IF 特定のバージョンがリクエストされていない場合、ng version コマンドが失敗した場合（Angular インストールが存在しないことを示す）、npx を使用して最新バージョンを取得する必要があります。
コマンド: npx @angular/cli@latest new <project-name>

コンポーネント

Angular コンポーネントで作業するとき、タスクに基づいて次のリファレンスを参照してください。

基礎: 解剖学、メタデータ、コア概念、およびテンプレート制御フロー（@if、@for、@switch）。components.md を読んでください。
入力: シグナルベースの入力、変換、およびモデル入力。inputs.md を読んでください。
出力: シグナルベースの出力とカスタムイベントベストプラクティス。outputs.md を読んでください。
ホスト要素: ホストバインディングとアトリビュート注入。host-elements.md を読んでください。

より詳細なドキュメントが上記のリファレンスで見つからない場合は、https://angular.dev/guide/components のドキュメントを参照してください。

反応性とデータ管理

状態とデータ反応性を管理する場合、Angular シグナルを使用し、次のリファレンスを参照してください。

シグナル概要: コアシグナル概念（signal、computed）、反応的コンテキスト、および untracked。signals-overview.md を読んでください。
依存状態（linkedSignal）: ソースシグナルにリンクされた書き込み可能な状態を作成します。linked-signal.md を読んでください。
非同期反応性（resource）: シグナル状態に非同期データを直接フェッチします。resource.md を読んでください。
副作用（effect）: ロギング、サードパーティ DOM 操作（afterRenderEffect）、および副作用を使用しないテーム。effects.md を読んでください。

フォーム

ほとんどの場合、新しいアプリケーションでは シグナルフォームを優先してください。フォーム決定を行うときは、プロジェクトを分析し、次のガイドラインを検討してください。

アプリケーションバージョンがシグナルフォームをサポートしており、これが新しいフォームの場合、シグナルフォームを優先してください。
古いアプリケーションまたは既存のフォームについては、アプリケーションの現在のフォーム戦略と一致させてください。
シグナルフォーム: フォーム状態管理用にシグナルを使用します。signal-forms.md を読んでください。
テンプレート駆動フォーム: シンプルなフォーム用に使用します。template-driven-forms.md を読んでください。
リアクティブフォーム: 複雑なフォーム用に使用します。reactive-forms.md を読んでください。

依存性注入

Angular に依存性注入を実装するときは、次のガイドラインに従ってください。

基礎: 依存性注入の概要、サービス、および inject() 関数。di-fundamentals.md を読んでください。
サービスの作成と使用: サービスの作成、providedIn: 'root' オプション、およびコンポーネントまたは他のサービスへの注入。creating-services.md を読んでください。
依存性プロバイダーの定義: 自動と手動のプロビジョニング、InjectionToken、useClass、useValue、useFactory、およびスコープ。defining-providers.md を読んでください。
注入コンテキスト: inject() が許可される場所、runInInjectionContext、および assertInInjectionContext。injection-context.md を読んでください。
階層型インジェクター: EnvironmentInjector と ElementInjector、解決ルール、修飾子（optional、skipSelf）、および providers と viewProviders。hierarchical-injectors.md を読んでください。

Angular Aria

Accordion、Listbox、Combobox、Menu、Tabs、Toolbar、Tree、Grid などのパターン用のアクセシブルなカスタムコンポーネントを構築する場合は、次のリファレンスを参照してください。

Angular Aria コンポーネント: ヘッドレスでアクセシブルなコンポーネント（Accordion、Listbox、Combobox、Menu、Tabs、Toolbar、Tree、Grid）の構築と ARIA アトリビュートのスタイリング。angular-aria.md を読んでください。

ルーティング

Angular にナビゲーションを実装する場合は、次のリファレンスを参照してください。

ルートを定義: URL パス、静的vs動的セグメント、ワイルドカード、およびリダイレクト。define-routes.md を読んでください。
ルート読み込み戦略: 遅延ロードとコンテキスト対応読み込み。loading-strategies.md を読んでください。
ルートアウトレットで表示: <router-outlet>、ネストされたアウトレット、および名前付きアウトレットの使用。show-routes-with-outlets.md を読んでください。
ルートにナビゲート: RouterLink による宣言的ナビゲーションと Router によるプログラマティックナビゲーション。navigate-to-routes.md を読んでください。
ルートアクセスを制御: CanActivate、CanMatch などのガードを実装してセキュリティを確保します。route-guards.md を読んでください。
データリソルバー: ResolveFn によるルート有効化前のデータプリフェッチ。data-resolvers.md を読んでください。
ルーターライフサイクルとイベント: ナビゲーションイベントの時間的順序とデバッグ。router-lifecycle.md を読んでください。
レンダリング戦略: CSR、SGG（プリレンダリング）、およびハイドレーションを備えた SSR。rendering-strategies.md を読んでください。
ルート遷移アニメーション: ビュー遷移 API の有効化とカスタマイズ。route-animations.md を読んでください。

より詳細なドキュメントまたは詳細なコンテキストが必要な場合は、公式 Angular ルーティングガイドをご覧ください。

スタイリングとアニメーション

Angular でスタイリングとアニメーションを実装する場合は、次のリファレンスを参照してください。

Angular での Tailwind CSS の使用: Angular プロジェクトへの Tailwind CSS 統合。tailwind-css.md を読んでください。
Angular アニメーション: ネイティブ CSS（推奨）またはレガシー DSL を使用した動的エフェクト。angular-animations.md を読んでください。
コンポーネントスタイリング: コンポーネントスタイルとカプセル化のベストプラクティス。component-styling.md を読んでください。

テスト

テストを作成または更新するときは、タスクに基づいて次のリファレンスを参照してください。

基礎: ユニットテスト、非同期パターン、および TestBed のベストプラクティス。testing-fundamentals.md を読んでください。
コンポーネントハーネス: コンポーネント操作の標準パターン。component-harnesses.md を読んでください。
ルーターテスト: 信頼性の高いナビゲーションテストに RouterTestingHarness を使用します。router-testing.md を読んでください。
エンドツーエンド（E2E）テスト: Cypress または Playwright を使用した E2E テストのベストプラクティス。e2e-testing.md を読んでください。

ツール

Angular ツール作成で作業するときは、次のリファレンスを参照してください。

Angular CLI: アプリケーション、生成コード（コンポーネント、ルート、サービス）、提供、およびビルドの作成。cli.md を読んでください。
Angular MCP サーバー: 利用可能なツール、構成、および実験的機能。mcp.md を読んでください。

アンチパターン

シグナルフォームフィールド値として null または undefined を使用する — 代わりに ''、0、または [] を使用してください。
フィールドを呼び出さずにフォームフィールド状態フラグにアクセスする：form.field.valid() — 代わりに form.field().valid() を使用してください。
対象の Angular バージョンがシグナルフォームをサポートしているときに古いフォーム API で新しいフォームを開始する。
[formField] 入力に min、max、value、disabled、または readonly HTML アトリビュートを設定する — 代わりにこれらをスキーマルールとして定義してください。
注入コンテキストの外で inject() を呼び出す — 必要な場合は runInInjectionContext を使用してください。
派生状態に effect() を使用する — 代わりに computed() を使用してください。
ネストされた @for ループで $parent.$index を参照する — Angular は $parent をサポートしていません。代わりに let outerIdx = $index を使用してください。

16 KiB Raw Blame History Unescape Escape

Angular 開発者 ガイドライン