🦀 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: セキュリティ監査との統合