スキルリポジトリの開発

kamae-rs スキルリポジトリで作業するコントリビューター向けである（スキルをインストールした先のプロジェクト向けではない）。検証スクリプトや例 crate のワークスペースが揃っていないと、スキル自体の変更が再現できない。

アプリケーション開発の手順は開発環境、チェックコマンドは品質ゲート、Actions 配線は CI セットアップを参照する。

前提条件

rustfmt、clippy、rustdoc を含む Rust ツールチェーン（スキルのみ編集する場合は rustdoc は任意）
Python 3（パッケージ検証とテンプレート適用に使用）

クローンとブートストラップ

git clone <repository-url>
cd kamae-rs
python3 scripts/validate_package.py

リポジトリに crate 配下の Rust ドメインコードもある場合は、ツールチェーンコンポーネントをインストールし cargo check を実行する。

インストールの確認

python3 scripts/validate_package.py
cargo run -q -p kamae-review-probe -- skills/kamae-rs/examples/taxi-request.rs --json

変更を加える前に、パッケージ検証が通ることを確認する。

ローカル品質ゲートの実行

品質ゲートのベースラインコマンドを実行する。このリポジトリでは追加で次も実行する:

python3 scripts/validate_package.py
cargo run -q -p kamae-review-probe -- skills/kamae-rs/examples/taxi-request.rs --json
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all-targets

フォーマットチェックが失敗したら cargo fmt --all で適用する。

スキルパッケージの作業

スキルは skills/kamae-rs/ 配下にある:

SKILL.md — ディスパッチガイドと frontmatter
“ — 詳細リファレンス
scripts/ — apply_templates.py などのヘルパースクリプト
assets/templates/ — インストール可能なプロジェクトテンプレート

新しいリファレンスを追加したら SKILL.md からリンクし、スキルディスパッチャが拾えるようにする。scripts/validate_package.py がリンクを検査できるよう、相対リンクを優先する。

crates/review-probe または scripts/validate_package.py を変更したら、コミット前に python3 scripts/validate_package.py と cargo test -p kamae-review-probe を実行する。

テスト用テンプレート適用

skills/kamae-rs/scripts/apply_templates.py はテンプレートをターゲットディレクトリにコピーする。テンプレート変更のテストには一時ディレクトリを使い、このリポジトリに影響を与えない:

mkdir -p /tmp/kamae-rs-test
python3 skills/kamae-rs/scripts/apply_templates.py --target /tmp/kamae-rs-test --ci backend --force

既存プロジェクトに適用するときは、先に --dry-run を使う。

コミット前

上記のローカル品質ゲート一式を実行する。
git diff で意図しないテンプレートや manifest 変更がないか確認する。
コミットは焦点を絞る: 1 論理変更 1 コミット。例: 新リファレンスと SKILL.md リンクを 1 コミットにし、無関係なツール更新は別コミットにする。

トラブルシューティング

パッケージ検証が新リンクで失敗: 対象ファイルが存在し、#anchor スラッグが見出しと一致すること（../../../DEVELOPMENT.md 参照）。
review probe が example で多数の lead を出す: taxi 例は意図的に本番契約の一部を省略している。probe 変更の検証には実ドメインコードで probe を使う。
インストール後にテンプレート CI パスが誤る: 生成 workflow の path/to/kamae-rs を vendored スクリプトパスまたは絶対インストール先に置き換える。

スキルに従うアプリケーション crate（このリポジトリではない）については開発環境を読む。