菜单
Rustプロジェクトのセットアップ、Cargo.toml管理、ワークスペース構成、依存関係管理、feature flags設定、クロスコンパイル設定を支援するスキル。「Rustプロジェクト作成」「Cargo.toml編集」「workspace構成」「クレート追加」「feature flag」「クロスコンパイル」「ビルドターゲット」「cargo new」「依存関係」など、Rustプロジェクトの構造やビルド設定に関する質問・作業が発生したら必ずこのスキルを使うこと。Rustコードを新規に書き始めるときも必ず参照すること。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | rust-cargo-project |
| description | Rustプロジェクトのセットアップ、Cargo.toml管理、ワークスペース構成、依存関係管理、feature flags設定、クロスコンパイル設定を支援するスキル。「Rustプロジェクト作成」「Cargo.toml編集」「workspace構成」「クレート追加」「feature flag」「クロスコンパイル」「ビルドターゲット」「cargo new」「依存関係」など、Rustプロジェクトの構造やビルド設定に関する質問・作業が発生したら必ずこのスキルを使うこと。Rustコードを新規に書き始めるときも必ず参照すること。 |
Rustプロジェクトの構造設計からビルド設定まで、cargo周りの作業を高品質に行うためのガイド。
新規プロジェクトでは以下を確認してから作業に入る：
cargo new か cargo new --lib かedition = "2021" 以上を使うrust-version フィールドを設定license フィールドを忘れずに[package]
name = "my-project"
version = "0.1.0"
edition = "2024"
rust-version = "1.85"
license = "MIT OR Apache-2.0"
cargo add コマンドを優先する。手動編集するときはバージョン指定を明示的に：
# 良い例: セマンティックバージョニングを意識
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }
# dev-dependencies と build-dependencies を分離
[dev-dependencies]
criterion = { version = "0.5", features = ["html_reports"] }
[build-dependencies]
cc = "1.0"
ライブラリクレートでは feature flags を活用して依存を最小化する：
[features]
default = ["std"]
std = []
serde = ["dep:serde"]
async = ["dep:tokio"]
# optional dependencies
[dependencies]
serde = { version = "1.0", optional = true, features = ["derive"] }
tokio = { version = "1", optional = true, features = ["rt-multi-thread"] }
原則：
default は最小限にする（ユーザが default-features = false で外せるように）dep: 構文で明示リリースビルドとデバッグの最適化：
[profile.release]
lto = true
codegen-units = 1
strip = true
[profile.dev]
opt-level = 0
[profile.dev.package."*"]
opt-level = 2 # 依存クレートはdevでも最適化
複数クレートがある場合はworkspaceにする：
my-project/
├── Cargo.toml # workspace root
├── crates/
│ ├── core/ # コアロジック（lib）
│ │ ├── Cargo.toml
│ │ └── src/lib.rs
│ ├── cli/ # CLIバイナリ
│ │ ├── Cargo.toml
│ │ └── src/main.rs
│ └── plugin-api/ # プラグインAPI（lib）
│ ├── Cargo.toml
│ └── src/lib.rs
└── examples/
workspace root の Cargo.toml：
[workspace]
members = ["crates/*"]
resolver = "2"
[workspace.package]
edition = "2024"
license = "MIT OR Apache-2.0"
version = "0.1.0"
[workspace.dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }
# workspace内クレートの相互参照
my-core = { path = "crates/core" }
子クレートからの参照：
[dependencies]
serde.workspace = true
my-core.workspace = true
# ターゲット一覧確認
rustup target list
# よく使うターゲット追加
rustup target add x86_64-unknown-linux-musl # musl静的リンク
rustup target add x86_64-pc-windows-gnu # Windows (GNU)
rustup target add aarch64-unknown-linux-gnu # ARM64 Linux
rustup target add wasm32-unknown-unknown # WebAssembly
# WSL2からWindowsバイナリをビルドする場合
[target.x86_64-pc-windows-gnu]
linker = "x86_64-w64-mingw32-gcc"
# musl静的リンク
[target.x86_64-unknown-linux-musl]
rustflags = ["-C", "target-feature=+crt-static"]
Dockerベースでクロスコンパイル環境を自動構築：
cargo install cross
cross build --target aarch64-unknown-linux-gnu --release
Cargo.lock をコミットするか — バイナリならコミットする、ライブラリなら .gitignore に入れる* — 絶対に使わない。再現性が壊れるpath 依存を publish — path と version を併記する（version = "0.1", path = "../core"）音楽関係専門の日本語から英語への翻訳者。日本語のmarkdownが修正されたら、英語版のドキュメントも修正すること。
編集された code に対して適切なフォーマットで、日本語、英語のコメントを記載する。
Rustの非同期プログラミングを支援するスキル。tokio/async-stdの使い方、async/awaitパターン、Send+Sync境界の問題解決、チャネル通信、タスクスポーン、非同期ストリーム、select/joinパターン、非同期トレイトをカバー。「async」「await」「tokio」「非同期」「並行」「spawn」「channel」「Send」「Sync」「Future」「ランタイム」など非同期に関する話題が出たら必ずこのスキルを使うこと。パフォーマンスのためにasyncを導入したいという相談にも使うこと。
Rustコードの品質管理を支援するスキル。clippy警告の解釈と修正、rustfmtの設定、cargo audit/cargo denyによるセキュリティ監査、unsafe監査、miriによる未定義動作検出をカバー。「clippy」「lint」「rustfmt」「フォーマット」「コード品質」「unsafe」「監査」「audit」「deny」「miri」「コードレビュー」「Rustのベストプラクティス」「イディオマティック」など品質改善に関する要求があれば必ずこのスキルを使うこと。Rustコードのレビュー依頼時にも参照すること。
RustでDSL（ドメイン固有言語）のパーサーを構築するためのスキル。nom、pest、winnowなどのパーサーコンビネータ、手書き再帰下降パーサー、REPL実装、ASTの設計をカバー。「パーサー」「DSL」「nom」「pest」「構文解析」「字句解析」「レキサー」「トークナイザー」「AST」「BNF」「文法定義」「REPL」「ライブコーディング言語」などパーサーや言語設計に関する話題が出たら必ずこのスキルを使うこと。lcvgcのDSL実装時にも積極的に参照すること。
Rustのエラーハンドリング設計を支援するスキル。thiserror/anyhowの使い分け、カスタムエラー型設計、unwrap/expectの撲滅、Result型のイディオマティックな扱い、エラー伝播パターンをカバー。「エラー処理」「エラーハンドリング」「unwrap減らしたい」「thiserror」「anyhow」「Result」「?演算子」「パニック」「エラー型設計」などエラーに関する話題が出たら必ずこのスキルを使うこと。既存コードのリファクタリングでunwrapを見つけたときも参照すること。