rust-development

Original source / Raw SKILL.md

---
name: Rust Development Workflow
description: Execute comprehensive Rust development workflow including cargo build, test, clippy, and fmt. Use when compiling, testing, or checking Rust code quality. Note: CCAGI is primarily Node.js/TypeScript; this skill is for Rust components if needed.
allowed-tools: Bash, Read, Grep, Glob
---

# 🦀 Rust Development Workflow

**Version**: 2.0.1 (Reference for Rust components)
**Last Updated**: 2025-12-04
**Priority**: ⭐⭐⭐⭐⭐ (P0 Level)
**Purpose**: Rustビルド・テスト・品質チェックの最適化実行

---

## 📋 概要

Ccagiプロジェクトにおける完全なRust開発ワークフロー。
コード品質、型安全性、包括的テストを保証します。

---

## 🎯 P0: 呼び出しトリガー

| トリガー | 例 |
|---------|-----|
| ビルド | "build the project", "compile" |
| テスト | "run tests", "test this" |
| 品質チェック | "check code quality", "lint" |
| コミット前 | "before committing" |
| 新機能実装後 | "after implementing" |

---

## 🔧 P1: コマンド別最適化

### コマンド優先順位

| コマンド | 用途 | 平均時間 | 頻度 |
|---------|------|---------|------|
| `cargo check` | 型チェック（高速） | 10-30s | 高 |
| `cargo build` | デバッグビルド | 30-120s | 高 |
| `cargo build --release` | リリースビルド | 60-300s | 低 |
| `cargo test` | テスト実行 | 60-180s | 高 |
| `cargo clippy` | リントチェック | 30-60s | 中 |
| `cargo fmt` | フォーマット | 5-10s | 高 |
| `cargo doc` | ドキュメント生成 | 30-60s | 低 |

### 最適パターン

```
✅ GOOD: シーケンシャル実行（依存関係あり）
cargo build && cargo test && cargo clippy -- -D warnings && cargo fmt -- --check

❌ BAD: 個別実行（オーバーヘッド大）
cargo build → 結果確認 → cargo test → 結果確認 → ...
```

---

## 🚀 P2: ワークフロー別パターン

### Pattern 1: クイックチェック（開発中）

```bash
# 最小限のチェック（2-3分）
cargo check && cargo test -- --test-threads=1
```

**用途**: コード変更の即時検証

### Pattern 2: 標準ビルドサイクル（コミット前）

```bash
# フルチェック（5-10分）
cargo build --workspace && \
cargo test --workspace --all-features && \
cargo clippy --workspace --all-targets --all-features -- -D warnings && \
cargo fmt --all -- --check
```

**用途**: コミット前の品質保証

### Pattern 3: クリーンビルド（問題発生時）

```bash
# クリーンビルド（10-15分）
cargo clean && \
cargo build --workspace && \
cargo test --workspace --all-features
```

**用途**: キャッシュ問題の解消

### Pattern 4: リリースビルド（デプロイ前）

```bash
# リリース準備（15-20分）
cargo build --release --workspace && \
cargo test --release --workspace && \
cargo bench --no-run
```

**用途**: 本番デプロイ前の最終確認

### Pattern 5: ドキュメント生成

```bash
# ドキュメント（3-5分）
cargo doc --workspace --no-deps --all-features
```

**用途**: API ドキュメント更新

---

## ⚡ P3: パフォーマンス最適化

### 並列ビルド設定

```bash
# CPUコア数に応じた並列度
cargo build -j 8
cargo test -- --test-threads=8
```

### インクリメンタルビルド活用

```
# キャッシュ有効（高速）
target/debug/deps/
target/release/deps/

# キャッシュ無効化が必要な場合
CARGO_INCREMENTAL=0 cargo build
```

### ビルド時間比較

| 条件 | フルビルド | インクリメンタル |
|------|-----------|----------------|
| Debug | 2-3分 | 10-30秒 |
| Release | 5-10分 | 30-60秒 |
| Clean | 5-10分 | N/A |

---

## 📊 プロジェクト固有設定

### Cargo Workspace構造

```
ccagi-private/
├── Cargo.toml (workspace root)
├── crates/
│   ├── ccagi-types/      # コア型定義
│   ├── ccagi-core/       # 共通ユーティリティ
│   ├── ccagi-cli/        # CLIバイナリ
│   ├── ccagi-agents/     # Agent実装
│   ├── ccagi-github/     # GitHub API統合
│   ├── ccagi-worktree/   # Git Worktree管理
│   └── ccagi-llm/        # LLMプロバイダー抽象化
└── target/
```

### 依存関係チェック

```bash
# 主要依存関係
tokio         # 非同期ランタイム
async-trait   # Trait非同期メソッド
serde         # シリアライゼーション
octocrab      # GitHub API
tracing       # ログ
```

---

## 🛡️ エラーハンドリング

### 共通エラーパターン

| エラー | 原因 | 対処 |
|--------|------|------|
| `error[E0277]` | Trait未実装 | `async-trait`使用確認 |
| `error[E0412]` | 型未定義 | `use`文追加 |
| `error[E0433]` | モジュール未解決 | パス確認 |
| Clippy警告 | コード品質 | 警告に従い修正 |
| fmt差分 | フォーマット | `cargo fmt`実行 |

### テスト失敗時

```bash
# 並列実行問題の場合
cargo test -- --test-threads=1

# 特定テストのデバッグ
cargo test test_name -- --nocapture

# 詳細出力
RUST_BACKTRACE=1 cargo test
```

---

## ✅ 成功基準

| チェック項目 | 基準 |
|-------------|------|
| `cargo build` | 0 errors |
| `cargo test` | 100% pass |
| `cargo clippy` | 0 warnings |
| `cargo fmt --check` | 0 diff |
| `cargo doc` | 0 warnings |

### 出力フォーマット

```
🦀 Rust Development Workflow Results

✅ Build: Success (X crates compiled)
✅ Tests: XX/XX passed (XXX assertions)
✅ Clippy: 0 warnings
✅ Format: All files properly formatted
✅ Docs: Generated successfully

Ready to commit ✓
```

---

## 🔗 関連ドキュメント

| ドキュメント | 用途 |
|-------------|------|
| `context/rust.md` | Rust開発ガイドライン |
| `context/rust-tool-use-rules.md` | MCP Tool最適化 |
| `agents/RUST_COMMANDS_OPTIMIZATION.md` | Agent向け最適化 |

---

## 📝 関連Skills

- **Agent Execution**: Agent実行前のビルド確認
- **Git Workflow**: コミット前の品質チェック
- **Security Audit**: セキュリティ監査との統合