Rust 開発 (Lean)

使用するタイミング

• .rs ファイルと Cargo.toml
• 非同期サービス、CLI ツール、システムコンポーネント
• オーナーシップ/ライフタイム、トレイト、またはパフォーマンス周りの作業

デフォルト設定

• ライブラリの境界では明示的なエラー型を優先します。
• unsafe の使用は分離し、ドキュメント化します。
• clippy と rustfmt を必須の品質ゲートとして使用します。
• 複雑なライフタイムより、シンプルなオーナーシップフローを優先します。

クイックワークフロー

1. クレートの境界と公開 API を確認します。
2. 明確な型とエラーハンドリングで最小限の変更を実装します。
3. 変更された動作に対するテストを追加・更新します。
4. fmt、clippy、テストを実行します。

コマンド

• フォーマット: cargo fmt --all
• リント: cargo clippy --all-targets --all-features -- -D warnings
• テスト: cargo test --all-features
• リリースビルド: cargo build --release

実装チェックリスト

• Result<T, E> と ? が一貫して使用されている。
• テストコード以外のコードパスではパニックを回避している。
• シリアライゼーション契約は外部に公開される場合はバージョン管理されている。
• 並行プリミティブが意図的に選択されている (Mutex、RwLock、チャネル、セマフォ)。

検証チェックリスト

• cargo fmt が完全である。
• cargo clippy が完全である。
• テストが合格している。
• 新しい依存関係が正当化されている。

リファレンス

• references/reference.md - コンパクトなガイダンスとドキュメントリンク
• references/examples.md - 簡潔なサービス/テストパターン
• ../AGENT_SKILL_SPEC.md - 共有の Anthropic/Copilot アライメント