mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-19 23:33:07 +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:
187
docs/ja-JP/commands/rust-build.md
Normal file
187
docs/ja-JP/commands/rust-build.md
Normal file
@@ -0,0 +1,187 @@
|
||||
---
|
||||
description: Rustビルドエラー、ボローチェッカーの問題、依存関係の問題をインクリメンタルに修正します。最小限の外科的修正のためにrust-build-resolverエージェントを呼び出します。
|
||||
---
|
||||
|
||||
# Rustビルドと修正
|
||||
|
||||
このコマンドは**rust-build-resolver**エージェントを呼び出し、Rustビルドエラーを最小限の変更でインクリメンタルに修正します。
|
||||
|
||||
## このコマンドの動作
|
||||
|
||||
1. **診断を実行**: `cargo check`、`cargo clippy`、`cargo fmt --check`を実行
|
||||
2. **エラーを解析**: エラーコードと影響を受けるファイルを特定
|
||||
3. **インクリメンタルに修正**: 一度に1つのエラー
|
||||
4. **各修正を検証**: 各変更後に`cargo check`を再実行
|
||||
5. **サマリーを報告**: 修正されたものと残りを表示
|
||||
|
||||
## 使用するタイミング
|
||||
|
||||
`/rust-build`を使用するのは:
|
||||
- `cargo build`または`cargo check`がエラーで失敗する場合
|
||||
- `cargo clippy`が警告を報告する場合
|
||||
- ボローチェッカーやライフタイムエラーがコンパイルをブロックする場合
|
||||
- Cargo依存関係の解決が失敗する場合
|
||||
- ビルドを壊す変更をプルした後
|
||||
|
||||
## 実行される診断コマンド
|
||||
|
||||
```bash
|
||||
# プライマリビルドチェック
|
||||
cargo check 2>&1
|
||||
|
||||
# リントと提案
|
||||
cargo clippy -- -D warnings 2>&1
|
||||
|
||||
# フォーマットチェック
|
||||
cargo fmt --check 2>&1
|
||||
|
||||
# 依存関係の問題
|
||||
cargo tree --duplicates
|
||||
|
||||
# セキュリティ監査(利用可能な場合)
|
||||
if command -v cargo-audit >/dev/null; then cargo audit; else echo "cargo-audit not installed"; fi
|
||||
```
|
||||
|
||||
## セッション例
|
||||
|
||||
````text
|
||||
User: /rust-build
|
||||
|
||||
Agent:
|
||||
# Rustビルド解決
|
||||
|
||||
## 初期診断
|
||||
|
||||
```bash
|
||||
$ cargo check
|
||||
error[E0502]: cannot borrow `map` as mutable because it is also borrowed as immutable
|
||||
--> src/service/cache.rs:25:5
|
||||
error[E0308]: mismatched types
|
||||
--> src/handler/api.rs:42:12
|
||||
error[E0425]: cannot find value `db` in this scope
|
||||
--> src/handler/api.rs:58:9
|
||||
```
|
||||
|
||||
検出されたエラー: 3
|
||||
|
||||
## 修正 1: ボローチェッカーエラー
|
||||
|
||||
File: src/service/cache.rs:25
|
||||
Error: E0502 — イミュータブルとしてもボローされているため、`map`をミュータブルとしてボローできない
|
||||
Cause: ミュータブルなinsert中にイミュータブルなボローがまだアクティブ
|
||||
|
||||
```rust
|
||||
// 変更: ミュータブルアクセス前にイミュータブルなボローを終了するよう再構築
|
||||
if !map.contains_key("key") {
|
||||
map.insert("key".into(), default);
|
||||
}
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cargo check
|
||||
# 残りエラー: 2
|
||||
```
|
||||
|
||||
## 修正 2: 型の不一致
|
||||
|
||||
File: src/handler/api.rs:42
|
||||
Error: E0308 — mismatched types: expected `usize`, found `&str`
|
||||
|
||||
```rust
|
||||
// 変更前
|
||||
let count = params.get("count");
|
||||
// 変更後
|
||||
let count: usize = params.get("count")
|
||||
.and_then(|s| s.parse().ok())
|
||||
.unwrap_or(0);
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cargo check
|
||||
# 残りエラー: 1
|
||||
```
|
||||
|
||||
## 修正 3: 未解決の名前
|
||||
|
||||
File: src/handler/api.rs:58
|
||||
Error: E0425 — cannot find value `db` in this scope
|
||||
Cause: importの欠落
|
||||
|
||||
```rust
|
||||
// 追加
|
||||
use crate::db;
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cargo check
|
||||
# ビルド成功!
|
||||
```
|
||||
|
||||
## 最終検証
|
||||
|
||||
```bash
|
||||
$ cargo clippy -- -D warnings
|
||||
# 警告なし
|
||||
|
||||
$ cargo test
|
||||
running 6 tests
|
||||
test service::cache::tests::test_insert ... ok
|
||||
test service::cache::tests::test_get ... ok
|
||||
test handler::api::tests::test_parse_count ... ok
|
||||
test handler::api::tests::test_missing_count ... ok
|
||||
test handler::api::tests::test_db_import ... ok
|
||||
test handler::api::tests::test_response ... ok
|
||||
|
||||
test result: ok. 6 passed; 0 failed; 0 ignored
|
||||
```
|
||||
|
||||
## サマリー
|
||||
|
||||
| メトリクス | 件数 |
|
||||
|-----------|------|
|
||||
| 修正されたビルドエラー | 3 |
|
||||
| 修正されたClippy警告 | 0 |
|
||||
| 変更されたファイル | 2 |
|
||||
| 残りの問題 | 0 |
|
||||
|
||||
ビルドステータス: SUCCESS
|
||||
````
|
||||
|
||||
## 一般的に修正されるエラー
|
||||
|
||||
| エラー | 典型的な修正 |
|
||||
|--------|-------------|
|
||||
| `cannot borrow as mutable` | イミュータブルなボローを先に終了するよう再構築。cloneは正当化された場合のみ |
|
||||
| `does not live long enough` | 所有型を使用またはライフタイム注釈を追加 |
|
||||
| `cannot move out of` | 所有権を取るよう再構築。cloneは最後の手段としてのみ |
|
||||
| `mismatched types` | `.into()`、`as`、または明示的な変換を追加 |
|
||||
| `trait X not implemented` | `#[derive(Trait)]`を追加または手動で実装 |
|
||||
| `unresolved import` | Cargo.tomlに追加または`use`パスを修正 |
|
||||
| `cannot find value` | importを追加またはパスを修正 |
|
||||
|
||||
## 修正戦略
|
||||
|
||||
1. **ビルドエラーを最初に** — コードがコンパイルされなければならない
|
||||
2. **Clippy警告を次に** — 疑わしい構造を修正
|
||||
3. **フォーマットを3番目に** — `cargo fmt`準拠
|
||||
4. **一度に1つの修正** — 各変更を検証
|
||||
5. **最小限の変更** — リファクタリングせず、修正のみ
|
||||
|
||||
## 停止条件
|
||||
|
||||
エージェントは以下の場合に停止して報告する:
|
||||
- 3回の試行後も同じエラーが持続
|
||||
- 修正がより多くのエラーを導入
|
||||
- アーキテクチャ変更が必要
|
||||
- ボローチェッカーエラーがデータ所有権の再設計を必要とする
|
||||
|
||||
## 関連コマンド
|
||||
|
||||
- `/rust-test` — ビルド成功後にテストを実行
|
||||
- `/rust-review` — コード品質をレビュー
|
||||
- `verification-loop`スキル — 完全な検証ループ
|
||||
|
||||
## 関連
|
||||
|
||||
- エージェント: `agents/rust-build-resolver.md`
|
||||
- スキル: `skills/rust-patterns/`
|
||||
Reference in New Issue
Block a user