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

Rust Development Workflow