mcpField
R
readiness-report

readiness-report

github.com/openhandsエージェントワークフロー17587 回インストール今日更新
リポジトリ

readiness-report について

readiness-reportは、自律型AI開発に向けたリポジトリの準備状況を評価するスキルです。技術面の柱ごとに確認し、成熟度レベルと優先度付きの改善点を示します。

主な機能

  1. 01リポジトリ設定とツールの分析
  2. 029つの技術領域の評価
  3. 035段階の成熟度スコア
  4. 04優先度付き改善提案
  5. 05基準ごとの結果レポート

活用シーン

  1. 01AI開発導入前のリポジトリ評価
  2. 02ドキュメントや開発ツールの不足確認
  3. 03コーディングエージェント向けの改善優先順位付け

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openhands/extensions --skill readiness-report

インストール後、Claude Code で/readiness-reportを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
criteria.md
maturity-levels.md
scripts/
analyze_repo.py
generate_report.py

詳細

エージェント対応状況レポート

8つの技術的な柱と5段階の成熟度レベルに基づいてリポジトリを分析し、自律型AI開発への対応状況を評価します。

概要

エージェント対応状況では、AI支援開発に向けたコードベースの準備状況を測定します。フィードバックループの不備、ドキュメントの不足、ツールの欠如があると、エージェントは防げるはずのエラーへの対処に時間を費やします。このスキルはそうした課題を特定し、修正の優先順位を決めます。

クイックスタート

ユーザーが /readiness-report を実行すると、現在のリポジトリが評価されます。その後、エージェントは次の処理を行います。

  1. リポジトリをクローンし、構造、CI 設定、ツールをスキャンします
  2. 9つの技術的な柱にわたる81の基準を評価します
  3. 各レベルの基準を80％以上満たしているかに基づいて、成熟度レベル（L1～L5）を判定します
  4. 優先順位を付けた推奨事項を提示します

ワークフロー

ステップ1：リポジトリを分析する

分析スクリプトを実行し、リポジトリからシグナルを収集します。

python scripts/analyze_repo.py --repo-path .

このスクリプトでは、次の項目を確認します。

  • 設定ファイル（.eslintrc、pyproject.toml など）
  • CI/CD ワークフロー（.github/workflows/、.gitlab-ci.yml）
  • ドキュメント（README、AGENTS.md、CONTRIBUTING.md）
  • テスト基盤（テストディレクトリ、カバレッジ設定）
  • セキュリティ設定（CODEOWNERS、.gitignore、シークレット管理）
ステップ2：レポートを生成する

分析の後、書式を整えたレポートを生成します。

python scripts/generate_report.py --analysis-file /tmp/readiness_analysis.json
ステップ3：結果を提示する

レポートには次の内容が含まれます。

  1. 総合スコア：合格率と達成した成熟度レベル
  2. レベルの進捗状況：L1～L5の達成率を示すバー
  3. 強み：基準を満たした、特に優れた柱
  4. 改善の機会：実施する改善項目を優先順位順に並べたリスト
  5. 詳細な基準：柱ごとに各基準のステータスを示す詳細

9つの技術的な柱

各柱では、AI支援開発における具体的な失敗要因に対処します。

柱目的主なシグナル
スタイルと検証バグを即座に検出するリンター、フォーマッター、型チェッカー
ビルドシステム高速で信頼性の高いビルドビルドのドキュメント、CI の速度、自動化
テスト正しさを検証する単体テスト／統合テスト、カバレッジ
ドキュメントエージェントを導くAGENTS.md、README、アーキテクチャのドキュメント
開発環境再現可能なセットアップDev Container、環境テンプレート
デバッグと可観測性問題を診断するログ、トレース、メトリクス
セキュリティコードベースを保護するCODEOWNERS、シークレット管理
タスクの発見対応する作業を見つけるIssue テンプレート、PR テンプレート
プロダクトと分析エラーから知見を得るループエラートラッキング、プロダクト分析

各柱の全81項目の基準については、references/criteria.md を参照してください。

5段階の成熟度レベル

レベル名称説明エージェントの能力
L1初期基本的なバージョン管理手動での支援のみ
L2管理基本的な CI/CD とテスト単純で明確に定義されたタスク
L3標準化エージェントが本番環境で使える状態定常的なメンテナンス
L4測定包括的な自動化複雑な機能
L5最適化完全な自律実行能力開発の全工程

レベルの進行条件：あるレベルに到達するには、そのレベルの基準を80％以上満たし、かつそれ以前のすべてのレベルの基準を満たす必要があります。

各レベルの詳しい要件については、references/maturity-levels.md を参照してください。

結果の解釈

合格・不合格・スキップ
  • ✓ 合格：基準を満たしています（スコアに加算されます）
  • ✗ 不合格：基準を満たしていません（改善の機会があります）
  • — スキップ：このリポジトリの種類には該当しません（スコアから除外されます）
優先順位

次の順に課題を修正してください。

  1. L1～L2の不合格項目：エージェントの基本動作を妨げる基盤上の問題
  2. L3の不合格項目：本番環境で使うための準備に関する不足
  3. 影響度の高いL4以上の不合格項目：最適化の機会
よくあるすぐにできる改善
  1. AGENTS.md を追加する：AI エージェント向けにコマンド、アーキテクチャ、ワークフローを文書化します
  2. pre-commit フックを設定する：CI の前にスタイルの問題を検出します
  3. PR／issue テンプレートを追加する：タスクの発見を構造化します
  4. ワンコマンドでのセットアップを文書化する：環境をすばやく準備できるようにします

リソース

  • scripts/analyze_repo.py - リポジトリ分析スクリプト
  • scripts/generate_report.py - レポートの生成と書式設定
  • references/criteria.md - 各柱の基準を網羅した定義
  • references/maturity-levels.md - 各レベルの詳細な要件

自動修正

レポートを確認した後、よくある修正は自動化できます。

  • リポジトリ構造から AGENTS.md を生成する
  • 不足している issue／PR テンプレートを追加する
  • 標準的なリンターとフォーマッターを設定する
  • pre-commit フックをセットアップする

失敗した基準の自動修正を開始するには、「fix readiness gaps」と依頼してください。

コメント

Markdown 対応