mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 06:43: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:
42
docs/ja-JP/rules/python/coding-style.md
Normal file
42
docs/ja-JP/rules/python/coding-style.md
Normal file
@@ -0,0 +1,42 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.py"
|
||||
- "**/*.pyi"
|
||||
---
|
||||
# Python コーディングスタイル
|
||||
|
||||
> このファイルは [common/coding-style.md](../common/coding-style.md) を Python 固有のコンテンツで拡張します。
|
||||
|
||||
## 標準
|
||||
|
||||
- **PEP 8** 規約に従う
|
||||
- すべての関数シグネチャに**型アノテーション**を使用する
|
||||
|
||||
## 不変性
|
||||
|
||||
不変データ構造を優先する:
|
||||
|
||||
```python
|
||||
from dataclasses import dataclass
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class User:
|
||||
name: str
|
||||
email: str
|
||||
|
||||
from typing import NamedTuple
|
||||
|
||||
class Point(NamedTuple):
|
||||
x: float
|
||||
y: float
|
||||
```
|
||||
|
||||
## フォーマット
|
||||
|
||||
- **black** — コードフォーマット
|
||||
- **isort** — インポートの並べ替え
|
||||
- **ruff** — リンティング
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `python-patterns` で包括的な Python のイディオムとパターンを参照してください。
|
||||
58
docs/ja-JP/rules/python/fastapi.md
Normal file
58
docs/ja-JP/rules/python/fastapi.md
Normal file
@@ -0,0 +1,58 @@
|
||||
---
|
||||
paths:
|
||||
- "**/app/**/*.py"
|
||||
- "**/fastapi/**/*.py"
|
||||
- "**/*_api.py"
|
||||
---
|
||||
# FastAPI ルール
|
||||
|
||||
FastAPI プロジェクトでは、一般的な Python ルールと併せてこれらのルールを使用してください。
|
||||
|
||||
## 構造
|
||||
|
||||
- アプリの構築は `create_app()` に配置する。
|
||||
- ルーターは薄く保つ; 永続化とビジネスロジックはサービスまたは CRUD ヘルパーに移動する。
|
||||
- リクエストスキーマ、更新スキーマ、レスポンススキーマは分離する。
|
||||
- データベースセッションと認証は依存関係に配置する。
|
||||
|
||||
## 非同期
|
||||
|
||||
- I/O を実行するエンドポイントには `async def` を使用する。
|
||||
- 非同期エンドポイントからは非同期データベースクライアントと HTTP クライアントを使用する。
|
||||
- 非同期ルートから `requests`、同期 SQLAlchemy セッション、またはブロッキングファイル/ネットワーク操作を呼び出さない。
|
||||
|
||||
## 依存性注入
|
||||
|
||||
```python
|
||||
@router.get("/users/{user_id}")
|
||||
async def get_user(
|
||||
user_id: str,
|
||||
db: AsyncSession = Depends(get_db),
|
||||
current_user: User = Depends(get_current_user),
|
||||
):
|
||||
...
|
||||
```
|
||||
|
||||
ルートハンドラ内で `SessionLocal()` や長寿命クライアントを作成しない。
|
||||
|
||||
## スキーマ
|
||||
|
||||
- レスポンスモデルにパスワード、パスワードハッシュ、アクセストークン、リフレッシュトークン、内部認証状態を含めない。
|
||||
- アプリケーションデータを返すエンドポイントには `response_model` を使用する。
|
||||
- 手書きのバリデーションの代わりに、Pydantic でルールを表現できる場合はフィールド制約を使用する。
|
||||
|
||||
## セキュリティ
|
||||
|
||||
- CORS オリジンは環境固有にする。
|
||||
- ワイルドカードオリジンと認証情報付き CORS を組み合わせない。
|
||||
- JWT の有効期限、発行者、オーディエンス、アルゴリズムを検証する。
|
||||
- 認証および書き込み負荷の高いエンドポイントにレート制限を適用する。
|
||||
- ログから認証情報、Cookie、Authorization ヘッダー、トークンを除去する。
|
||||
|
||||
## テスト
|
||||
|
||||
- `Depends` で使用される正確な依存関係をオーバーライドする。
|
||||
- テスト後に `app.dependency_overrides` をクリアする。
|
||||
- 非同期アプリケーションには非同期テストクライアントを優先する。
|
||||
|
||||
スキル: `fastapi-patterns` を参照してください。
|
||||
19
docs/ja-JP/rules/python/hooks.md
Normal file
19
docs/ja-JP/rules/python/hooks.md
Normal file
@@ -0,0 +1,19 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.py"
|
||||
- "**/*.pyi"
|
||||
---
|
||||
# Python フック
|
||||
|
||||
> このファイルは [common/hooks.md](../common/hooks.md) を Python 固有のコンテンツで拡張します。
|
||||
|
||||
## PostToolUse フック
|
||||
|
||||
`~/.claude/settings.json` で設定:
|
||||
|
||||
- **black/ruff**: 編集後に `.py` ファイルを自動フォーマット
|
||||
- **mypy/pyright**: `.py` ファイル編集後に型チェックを実行
|
||||
|
||||
## 警告
|
||||
|
||||
- 編集されたファイル内の `print()` 文について警告する(代わりに `logging` モジュールを使用)
|
||||
39
docs/ja-JP/rules/python/patterns.md
Normal file
39
docs/ja-JP/rules/python/patterns.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.py"
|
||||
- "**/*.pyi"
|
||||
---
|
||||
# Python パターン
|
||||
|
||||
> このファイルは [common/patterns.md](../common/patterns.md) を Python 固有のコンテンツで拡張します。
|
||||
|
||||
## Protocol(ダックタイピング)
|
||||
|
||||
```python
|
||||
from typing import Protocol
|
||||
|
||||
class Repository(Protocol):
|
||||
def find_by_id(self, id: str) -> dict | None: ...
|
||||
def save(self, entity: dict) -> dict: ...
|
||||
```
|
||||
|
||||
## DTO としての Dataclass
|
||||
|
||||
```python
|
||||
from dataclasses import dataclass
|
||||
|
||||
@dataclass
|
||||
class CreateUserRequest:
|
||||
name: str
|
||||
email: str
|
||||
age: int | None = None
|
||||
```
|
||||
|
||||
## コンテキストマネージャとジェネレータ
|
||||
|
||||
- リソース管理にはコンテキストマネージャ(`with` 文)を使用する
|
||||
- 遅延評価とメモリ効率の良いイテレーションにはジェネレータを使用する
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `python-patterns` でデコレータ、並行処理、パッケージ構成を含む包括的なパターンを参照してください。
|
||||
30
docs/ja-JP/rules/python/security.md
Normal file
30
docs/ja-JP/rules/python/security.md
Normal file
@@ -0,0 +1,30 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.py"
|
||||
- "**/*.pyi"
|
||||
---
|
||||
# Python セキュリティ
|
||||
|
||||
> このファイルは [common/security.md](../common/security.md) を Python 固有のコンテンツで拡張します。
|
||||
|
||||
## シークレット管理
|
||||
|
||||
```python
|
||||
import os
|
||||
from dotenv import load_dotenv
|
||||
|
||||
load_dotenv()
|
||||
|
||||
api_key = os.environ["OPENAI_API_KEY"] # 未設定の場合 KeyError を発生
|
||||
```
|
||||
|
||||
## セキュリティスキャン
|
||||
|
||||
- **bandit** を使用して静的セキュリティ解析を実行:
|
||||
```bash
|
||||
bandit -r src/
|
||||
```
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `django-security` で Django 固有のセキュリティガイドラインを参照してください(該当する場合)。
|
||||
38
docs/ja-JP/rules/python/testing.md
Normal file
38
docs/ja-JP/rules/python/testing.md
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.py"
|
||||
- "**/*.pyi"
|
||||
---
|
||||
# Python テスト
|
||||
|
||||
> このファイルは [common/testing.md](../common/testing.md) を Python 固有のコンテンツで拡張します。
|
||||
|
||||
## フレームワーク
|
||||
|
||||
テストフレームワークとして **pytest** を使用する。
|
||||
|
||||
## カバレッジ
|
||||
|
||||
```bash
|
||||
pytest --cov=src --cov-report=term-missing
|
||||
```
|
||||
|
||||
## テストの構成
|
||||
|
||||
テスト分類には `pytest.mark` を使用する:
|
||||
|
||||
```python
|
||||
import pytest
|
||||
|
||||
@pytest.mark.unit
|
||||
def test_calculate_total():
|
||||
...
|
||||
|
||||
@pytest.mark.integration
|
||||
def test_database_connection():
|
||||
...
|
||||
```
|
||||
|
||||
## リファレンス
|
||||
|
||||
スキル: `python-testing` で詳細な pytest パターンとフィクスチャを参照してください。
|
||||
Reference in New Issue
Block a user