mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 23:03:06 +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:
128
docs/ja-JP/commands/cpp-test.md
Normal file
128
docs/ja-JP/commands/cpp-test.md
Normal file
@@ -0,0 +1,128 @@
|
||||
---
|
||||
description: C++のTDDワークフローを強制します。最初にGoogleTestテストを書き、その後実装します。gcov/lcovでカバレッジを検証します。
|
||||
---
|
||||
|
||||
# C++ TDDコマンド
|
||||
|
||||
このコマンドはCMake/CTestとGoogleTest/GoogleMockを使用したC++コードのテスト駆動開発方法論を強制します。
|
||||
|
||||
## このコマンドの動作
|
||||
|
||||
1. **インターフェース定義**: クラス/関数のシグネチャを先にスキャフォールド
|
||||
2. **テストを書く**: 包括的なGoogleTestテストケースを作成(RED)
|
||||
3. **テストを実行**: テストが正しい理由で失敗することを検証
|
||||
4. **コードを実装**: テストを通す最小限のコードを書く(GREEN)
|
||||
5. **リファクタリング**: テストをグリーンに保ちながら改善
|
||||
6. **カバレッジをチェック**: 80%以上のカバレッジを確保
|
||||
|
||||
## 使用するタイミング
|
||||
|
||||
`/cpp-test`を使用するのは:
|
||||
- 新しいC++の関数やクラスを実装する時
|
||||
- 既存コードにテストカバレッジを追加する時
|
||||
- バグを修正する時(失敗するテストを最初に書く)
|
||||
- 重要なビジネスロジックを構築する時
|
||||
- C++でTDDワークフローを学ぶ時
|
||||
|
||||
## TDDサイクル
|
||||
|
||||
```
|
||||
RED → 失敗するGoogleTestテストを書く
|
||||
GREEN → テストを通す最小限のコードを実装
|
||||
REFACTOR → コードを改善、テストはグリーンのまま
|
||||
REPEAT → 次のテストケースへ
|
||||
```
|
||||
|
||||
## テストパターン
|
||||
|
||||
### 基本テスト
|
||||
```cpp
|
||||
TEST(SuiteName, TestName) {
|
||||
EXPECT_EQ(add(2, 3), 5);
|
||||
EXPECT_NE(result, nullptr);
|
||||
EXPECT_TRUE(is_valid);
|
||||
EXPECT_THROW(func(), std::invalid_argument);
|
||||
}
|
||||
```
|
||||
|
||||
### フィクスチャ
|
||||
```cpp
|
||||
class DatabaseTest : public ::testing::Test {
|
||||
protected:
|
||||
void SetUp() override { db_ = create_test_db(); }
|
||||
void TearDown() override { db_.reset(); }
|
||||
std::unique_ptr<Database> db_;
|
||||
};
|
||||
|
||||
TEST_F(DatabaseTest, InsertsRecord) {
|
||||
db_->insert("key", "value");
|
||||
EXPECT_EQ(db_->get("key"), "value");
|
||||
}
|
||||
```
|
||||
|
||||
### パラメータ化テスト
|
||||
```cpp
|
||||
class PrimeTest : public ::testing::TestWithParam<std::pair<int, bool>> {};
|
||||
|
||||
TEST_P(PrimeTest, ChecksPrimality) {
|
||||
auto [input, expected] = GetParam();
|
||||
EXPECT_EQ(is_prime(input), expected);
|
||||
}
|
||||
|
||||
INSTANTIATE_TEST_SUITE_P(Primes, PrimeTest, ::testing::Values(
|
||||
std::make_pair(2, true),
|
||||
std::make_pair(4, false),
|
||||
std::make_pair(7, true)
|
||||
));
|
||||
```
|
||||
|
||||
## カバレッジコマンド
|
||||
|
||||
```bash
|
||||
# カバレッジ付きビルド
|
||||
cmake -DCMAKE_CXX_FLAGS="--coverage" -DCMAKE_EXE_LINKER_FLAGS="--coverage" -B build
|
||||
|
||||
# テスト実行
|
||||
cmake --build build && ctest --test-dir build
|
||||
|
||||
# カバレッジレポート生成
|
||||
lcov --capture --directory build --output-file coverage.info
|
||||
lcov --remove coverage.info '/usr/*' --output-file coverage.info
|
||||
genhtml coverage.info --output-directory coverage_html
|
||||
```
|
||||
|
||||
## カバレッジ目標
|
||||
|
||||
| コードの種類 | 目標 |
|
||||
|-------------|------|
|
||||
| 重要なビジネスロジック | 100% |
|
||||
| パブリックAPI | 90%以上 |
|
||||
| 一般コード | 80%以上 |
|
||||
| 生成コード | 除外 |
|
||||
|
||||
## TDDベストプラクティス
|
||||
|
||||
**すべきこと:**
|
||||
- 実装の前にテストを先に書く
|
||||
- 各変更後にテストを実行
|
||||
- 適切な場合は`ASSERT_*`(停止)より`EXPECT_*`(続行)を使用
|
||||
- 実装の詳細ではなく動作をテスト
|
||||
- エッジケースを含める(空、null、最大値、境界条件)
|
||||
|
||||
**すべきでないこと:**
|
||||
- テストの前に実装を書く
|
||||
- RED段階をスキップ
|
||||
- プライベートメソッドを直接テスト(パブリックAPIを通じてテスト)
|
||||
- テストで`sleep`を使用
|
||||
- フレイキーなテストを無視
|
||||
|
||||
## 関連コマンド
|
||||
|
||||
- `/cpp-build` — ビルドエラーを修正
|
||||
- `/cpp-review` — 実装後にコードをレビュー
|
||||
- `verification-loop`スキル — 完全な検証ループを実行
|
||||
|
||||
## 関連
|
||||
|
||||
- スキル: `skills/cpp-testing/`
|
||||
- スキル: `skills/tdd-workflow/`
|
||||
Reference in New Issue
Block a user