エージェント対応度修正
リポジトリの対応度を安全な変更のみを適用して向上させます。エンジンは計画の立案と設定スキャフォールドの作成を行います。git操作や散文の作成はあなたが担当します。3つのバケット、3つの異なる安全レベル。
手順
-
レポートが存在することを確認する。
.agents/readiness/latest.jsonが存在しない場合は、最初に ra1-report スキルを実行します。 -
計画をドライランして何が変更されるかを確認します:
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>これにより3つのバケットが出力されます:自動適用(安全な設定スキャフォールド)、提案(レビュー用ドラフト)、GitHub設定(手動)。
-
まずローカルブランチを作成します(決してデフォルトブランチで作業しないでください):
git -C <repo-path> checkout -b readiness/fixes -
安全なスキャフォールドを適用します(冪等性あり;ダーティなワークツリーでは拒否;空でないファイルを上書きしない):
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply -
「提案」アイテムは自分で作成します — READMEセクション、カスタマイズされた
AGENTS.md、ランブック、最初のテスト。これらはユーザーがレビューするためのドラフトとして作成し、コードベースについて事実をでっち上げないでください。templates/AGENTS.mdは開始用のスケルトンです — リポジトリが実際に行っていることに基づいて埋めてください。 -
差分を表示し、ローカルでコミットします。 変更を要約し、次を実行します:
git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"コミットメッセージの末尾に必須の
Co-Authored-Byトレーラーを追加します。 -
ra1-report を再実行してレベルの変化を表示します。
契約(違反禁止)
- 明示的なユーザーの確認なしにプッシュしたりPRを開いたりしないでください。 最初にローカルでビルドしてコミットします。
- 設定スキャフォールドのみを自動適用します。 README/AGENTS.md/テスト/ランブックはユーザーがレビューする提案ドラフトです — 散文を自動で書くと「架空のドキュメント化」を招く恐れがあります。
- GitHub設定の変更(ブランチ保護、シークレットスキャン、ラベル)をコードコミットにまとめないでください。それらはユーザーが実行して確認するための
ghコマンドのチェックリストとして提示します。 - ダーティなワークツリーを尊重します:確認なしに
--forceで未コミットの作業を上書きしないでください。