🦀 Rust Development Workflow

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐⭐⭐ (P0 Level) Purpose: Rustビルド・テスト・品質チェックの最適化実行

---

📋 概要

Miyabiプロジェクトにおける完全な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: クイックチェック（開発中）

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

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

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

# フルチェック（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: クリーンビルド（問題発生時）

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

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

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

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

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

Pattern 5: ドキュメント生成

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

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

---

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

並列ビルド設定

# 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構造

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

依存関係チェック

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

---

🛡️ エラーハンドリング

共通エラーパターン

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

テスト失敗時

# 並列実行問題の場合
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: セキュリティ監査との統合