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:
44
docs/ja-JP/rules/cpp/coding-style.md
Normal file
44
docs/ja-JP/rules/cpp/coding-style.md
Normal file
@@ -0,0 +1,44 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.cpp"
|
||||
- "**/*.hpp"
|
||||
- "**/*.cc"
|
||||
- "**/*.hh"
|
||||
- "**/*.cxx"
|
||||
- "**/*.h"
|
||||
- "**/CMakeLists.txt"
|
||||
---
|
||||
# C++ コーディングスタイル
|
||||
|
||||
> このファイルは [common/coding-style.md](../common/coding-style.md) を C++ 固有のコンテンツで拡張します。
|
||||
|
||||
## モダン C++(C++17/20/23)
|
||||
|
||||
- C スタイルの構文よりも**モダン C++ の機能**を優先する
|
||||
- コンテキストから型が明らかな場合は `auto` を使用する
|
||||
- コンパイル時の定数には `constexpr` を使用する
|
||||
- 構造化バインディングを使用する: `auto [key, value] = map_entry;`
|
||||
|
||||
## リソース管理
|
||||
|
||||
- **RAII を徹底する** — 手動での `new`/`delete` は禁止
|
||||
- 独占的な所有権には `std::unique_ptr` を使用する
|
||||
- 共有所有権が本当に必要な場合のみ `std::shared_ptr` を使用する
|
||||
- 生の `new` の代わりに `std::make_unique` / `std::make_shared` を使用する
|
||||
|
||||
## 命名規則
|
||||
|
||||
- 型/クラス: `PascalCase`
|
||||
- 関数/メソッド: `snake_case` または `camelCase`(プロジェクトの規約に従う)
|
||||
- 定数: `kPascalCase` または `UPPER_SNAKE_CASE`
|
||||
- 名前空間: `lowercase`
|
||||
- メンバー変数: `snake_case_`(末尾アンダースコア)または `m_` プレフィックス
|
||||
|
||||
## フォーマット
|
||||
|
||||
- **clang-format** を使用する — スタイルの議論は不要
|
||||
- コミット前に `clang-format -i <file>` を実行する
|
||||
|
||||
## 参考
|
||||
|
||||
包括的な C++ コーディング標準とガイドラインについてはスキル: `cpp-coding-standards` を参照。
|
||||
39
docs/ja-JP/rules/cpp/hooks.md
Normal file
39
docs/ja-JP/rules/cpp/hooks.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.cpp"
|
||||
- "**/*.hpp"
|
||||
- "**/*.cc"
|
||||
- "**/*.hh"
|
||||
- "**/*.cxx"
|
||||
- "**/*.h"
|
||||
- "**/CMakeLists.txt"
|
||||
---
|
||||
# C++ フック
|
||||
|
||||
> このファイルは [common/hooks.md](../common/hooks.md) を C++ 固有のコンテンツで拡張します。
|
||||
|
||||
## ビルドフック
|
||||
|
||||
C++ の変更をコミットする前にこれらのチェックを実行する:
|
||||
|
||||
```bash
|
||||
# フォーマットチェック
|
||||
clang-format --dry-run --Werror src/*.cpp src/*.hpp
|
||||
|
||||
# 静的解析
|
||||
clang-tidy src/*.cpp -- -std=c++17
|
||||
|
||||
# ビルド
|
||||
cmake --build build
|
||||
|
||||
# テスト
|
||||
ctest --test-dir build --output-on-failure
|
||||
```
|
||||
|
||||
## 推奨 CI パイプライン
|
||||
|
||||
1. **clang-format** — フォーマットチェック
|
||||
2. **clang-tidy** — 静的解析
|
||||
3. **cppcheck** — 追加解析
|
||||
4. **cmake ビルド** — コンパイル
|
||||
5. **ctest** — サニタイザーを使用したテスト実行
|
||||
51
docs/ja-JP/rules/cpp/patterns.md
Normal file
51
docs/ja-JP/rules/cpp/patterns.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.cpp"
|
||||
- "**/*.hpp"
|
||||
- "**/*.cc"
|
||||
- "**/*.hh"
|
||||
- "**/*.cxx"
|
||||
- "**/*.h"
|
||||
- "**/CMakeLists.txt"
|
||||
---
|
||||
# C++ パターン
|
||||
|
||||
> このファイルは [common/patterns.md](../common/patterns.md) を C++ 固有のコンテンツで拡張します。
|
||||
|
||||
## RAII(Resource Acquisition Is Initialization)
|
||||
|
||||
リソースのライフタイムをオブジェクトのライフタイムに結びつける:
|
||||
|
||||
```cpp
|
||||
class FileHandle {
|
||||
public:
|
||||
explicit FileHandle(const std::string& path) : file_(std::fopen(path.c_str(), "r")) {}
|
||||
~FileHandle() { if (file_) std::fclose(file_); }
|
||||
FileHandle(const FileHandle&) = delete;
|
||||
FileHandle& operator=(const FileHandle&) = delete;
|
||||
private:
|
||||
std::FILE* file_;
|
||||
};
|
||||
```
|
||||
|
||||
## 5の法則/0の法則
|
||||
|
||||
- **0の法則**: カスタムデストラクタ、コピー/ムーブコンストラクタ、代入が不要なクラスを優先する
|
||||
- **5の法則**: デストラクタ/コピーコンストラクタ/コピー代入/ムーブコンストラクタ/ムーブ代入のいずれかを定義する場合、5つすべてを定義する
|
||||
|
||||
## 値セマンティクス
|
||||
|
||||
- 小さい/トリビアルな型は値渡しにする
|
||||
- 大きな型は `const&` で渡す
|
||||
- 値で返す(RVO/NRVO に依存する)
|
||||
- シンクパラメータにはムーブセマンティクスを使用する
|
||||
|
||||
## エラーハンドリング
|
||||
|
||||
- 例外的な状況には例外を使用する
|
||||
- 存在しない可能性のある値には `std::optional` を使用する
|
||||
- 想定される失敗には `std::expected`(C++23)または結果型を使用する
|
||||
|
||||
## 参考
|
||||
|
||||
包括的な C++ パターンとアンチパターンについてはスキル: `cpp-coding-standards` を参照。
|
||||
51
docs/ja-JP/rules/cpp/security.md
Normal file
51
docs/ja-JP/rules/cpp/security.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.cpp"
|
||||
- "**/*.hpp"
|
||||
- "**/*.cc"
|
||||
- "**/*.hh"
|
||||
- "**/*.cxx"
|
||||
- "**/*.h"
|
||||
- "**/CMakeLists.txt"
|
||||
---
|
||||
# C++ セキュリティ
|
||||
|
||||
> このファイルは [common/security.md](../common/security.md) を C++ 固有のコンテンツで拡張します。
|
||||
|
||||
## メモリ安全性
|
||||
|
||||
- 生の `new`/`delete` は絶対に使用しない — スマートポインタを使用する
|
||||
- C スタイルの配列は絶対に使用しない — `std::array` または `std::vector` を使用する
|
||||
- `malloc`/`free` は絶対に使用しない — C++ のアロケーションを使用する
|
||||
- 絶対に必要な場合を除き `reinterpret_cast` を避ける
|
||||
|
||||
## バッファオーバーフロー
|
||||
|
||||
- `char*` の代わりに `std::string` を使用する
|
||||
- 安全性が重要な場合の境界チェック付きアクセスには `.at()` を使用する
|
||||
- `strcpy`、`strcat`、`sprintf` は絶対に使用しない — `std::string` または `fmt::format` を使用する
|
||||
|
||||
## 未定義動作
|
||||
|
||||
- 変数を必ず初期化する
|
||||
- 符号付き整数のオーバーフローを避ける
|
||||
- NULL または dangling ポインタのデリファレンスを絶対に行わない
|
||||
- CI でサニタイザーを使用する:
|
||||
```bash
|
||||
cmake -DCMAKE_CXX_FLAGS="-fsanitize=address,undefined" ..
|
||||
```
|
||||
|
||||
## 静的解析
|
||||
|
||||
- 自動チェックには **clang-tidy** を使用する:
|
||||
```bash
|
||||
clang-tidy --checks='*' src/*.cpp
|
||||
```
|
||||
- 追加の解析には **cppcheck** を使用する:
|
||||
```bash
|
||||
cppcheck --enable=all src/
|
||||
```
|
||||
|
||||
## 参考
|
||||
|
||||
詳細なセキュリティガイドラインについてはスキル: `cpp-coding-standards` を参照。
|
||||
44
docs/ja-JP/rules/cpp/testing.md
Normal file
44
docs/ja-JP/rules/cpp/testing.md
Normal file
@@ -0,0 +1,44 @@
|
||||
---
|
||||
paths:
|
||||
- "**/*.cpp"
|
||||
- "**/*.hpp"
|
||||
- "**/*.cc"
|
||||
- "**/*.hh"
|
||||
- "**/*.cxx"
|
||||
- "**/*.h"
|
||||
- "**/CMakeLists.txt"
|
||||
---
|
||||
# C++ テスト
|
||||
|
||||
> このファイルは [common/testing.md](../common/testing.md) を C++ 固有のコンテンツで拡張します。
|
||||
|
||||
## フレームワーク
|
||||
|
||||
**CMake/CTest** と組み合わせた **GoogleTest**(gtest/gmock)を使用する。
|
||||
|
||||
## テストの実行
|
||||
|
||||
```bash
|
||||
cmake --build build && ctest --test-dir build --output-on-failure
|
||||
```
|
||||
|
||||
## カバレッジ
|
||||
|
||||
```bash
|
||||
cmake -DCMAKE_CXX_FLAGS="--coverage" -DCMAKE_EXE_LINKER_FLAGS="--coverage" ..
|
||||
cmake --build .
|
||||
ctest --output-on-failure
|
||||
lcov --capture --directory . --output-file coverage.info
|
||||
```
|
||||
|
||||
## サニタイザー
|
||||
|
||||
CI では常にサニタイザーを使用してテストを実行する:
|
||||
|
||||
```bash
|
||||
cmake -DCMAKE_CXX_FLAGS="-fsanitize=address,undefined" ..
|
||||
```
|
||||
|
||||
## 参考
|
||||
|
||||
詳細な C++ テストパターン、TDD ワークフロー、GoogleTest/GMock の使用方法についてはスキル: `cpp-testing` を参照。
|
||||
Reference in New Issue
Block a user