Communityライティング&編集github.com

tjboudreaux/ready-agent-1

Ready Agent 1 — あなたのコードベースはエージェントに対応していますか?エージェント対応度(決定論的、引用付き、レベル1〜5)をスコアリングし、ゲートをクリアします。

ready-agent-1 とは?

Ready Agent 1(RA1)は、コードベースのAIエージェント対応度を評価・向上させるためのスキルです。このスキルは、エージェントが効率的に動作するために必要な設定ファイル、README、AGENTS.md、テスト、ランブックなどを整備することで、コードベースの「レディネスレベル」(1〜5段階)を引き上げます。主にClaude CodeやCursorなどのAIエージェントツールでの使用を想定しており、決定論的で引用可能なスコアリングを行います。「自動適用」「提案」「手動設定」の3つのバケットに分けて変更を管理し、安全な設定スキャフォールドのみを自動適用し、散文ドキュメントはユーザー自身がレビュー・作成するという明確なコントラクトを持っています。レポート生成、変更のドライラン、安全な自動適用、ローカルコミット、レベルの再評価という一連のワークフローを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add tjboudreaux/ready-agent-1

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エージェント対応度修正

リポジトリの対応度を安全な変更のみを適用して向上させます。エンジンは計画の立案と設定スキャフォールドの作成を行います。git操作や散文の作成はあなたが担当します。3つのバケット、3つの異なる安全レベル。

手順

  1. レポートが存在することを確認する。 .agents/readiness/latest.json が存在しない場合は、最初に ra1-report スキルを実行します。

  2. 計画をドライランして何が変更されるかを確認します:

    python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>
    

    これにより3つのバケットが出力されます:自動適用(安全な設定スキャフォールド)、提案(レビュー用ドラフト)、GitHub設定(手動)。

  3. まずローカルブランチを作成します(決してデフォルトブランチで作業しないでください):

    git -C <repo-path> checkout -b readiness/fixes
    
  4. 安全なスキャフォールドを適用します(冪等性あり;ダーティなワークツリーでは拒否;空でないファイルを上書きしない):

    python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply
    
  5. 「提案」アイテムは自分で作成します — READMEセクション、カスタマイズされた AGENTS.md、ランブック、最初のテスト。これらはユーザーがレビューするためのドラフトとして作成し、コードベースについて事実をでっち上げないでください。templates/AGENTS.md は開始用のスケルトンです — リポジトリが実際に行っていることに基づいて埋めてください。

  6. 差分を表示し、ローカルでコミットします。 変更を要約し、次を実行します:

    git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"
    

    コミットメッセージの末尾に必須の Co-Authored-By トレーラーを追加します。

  7. ra1-report を再実行してレベルの変化を表示します。

契約(違反禁止)

  • 明示的なユーザーの確認なしにプッシュしたりPRを開いたりしないでください。 最初にローカルでビルドしてコミットします。
  • 設定スキャフォールドのみを自動適用します。 README/AGENTS.md/テスト/ランブックはユーザーがレビューする提案ドラフトです — 散文を自動で書くと「架空のドキュメント化」を招く恐れがあります。
  • GitHub設定の変更(ブランチ保護、シークレットスキャン、ラベル)をコードコミットにまとめないでください。それらはユーザーが実行して確認するための gh コマンドのチェックリストとして提示します。
  • ダーティなワークツリーを尊重します:確認なしに --force で未コミットの作業を上書きしないでください。

関連スキル