acreadiness-policy について
JSON で AgentRC の readiness ポリシーを設定するスキルです。基準、スコアへの影響、しきい値を調整し、チームのレポートや CI の成熟度要件に対応します。
主な機能
- 01有効なポリシーの表示
- 02JSON ポリシーのひな形作成
- 03基準の無効化や上書き
- 04スコアしきい値の設定
- 05ポリシー適用と CI ゲート
活用シーン
- 01組織の readiness 基準の設定
- 02プロジェクト構成に合わせたチェック調整
- 03CI で最低評価を適用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/acreadiness-policyを入力して読み込まれたか確認します。
詳細
/acreadiness-policy — AgentRC ポリシー
ユーザーが準備状況の ポリシー、厳格モード、カスタムスコアリング、チェックの無効化、組織標準、CI のゲーティングについて尋ねた場合に、このスキルを使用します。
ポリシーは、AgentRC の準備状況のスコアリング方法をカスタマイズする、criteria、extras、thresholds の3つの任意セクションを含む小さな JSON ファイルです。
組み込みの例
AgentRC には、examples/policies/ に3つのポリシー例が用意されています。
| ポリシー | 内容 |
|---|---|
strict.json | 100% の合格率を求め、主要な基準の重要度を引き上げます |
ai-only.json | リポジトリの健全性チェックをすべて無効にし、AI ツールに重点を置きます |
repo-health-only.json | AI チェックを無効にし、従来の品質に重点を置きます |
カスタムポリシーを作成する前に、これらを出発点としておすすめしてください。
ポリシースキーマ
{
"name": "my-policy",
"criteria": {
"disable": ["env-example", "observability", "dependabot"],
"override": {
"readme": { "impact": "high", "level": 2 },
"lint-config": { "title": "Linter required" }
}
},
"extras": {
"disable": ["pre-commit"]
},
"thresholds": {
"passRate": 0.9
}
}
重要度の重み
| 重要度 | 重み |
|---|---|
| critical | 5 |
| high | 4 |
| medium | 3 |
| low | 2 |
| info | 0 |
Score = 1 − (deductions / max possible weight)。評価：A ≥ 0.9、B ≥ 0.8、C ≥ 0.7、D ≥ 0.6、F < 0.6。
サブコマンド
show
現在有効なポリシーを一覧表示します（agentrc.config.json の policies 配列にあるもの。ない場合はなし）。
new <name>
妥当なデフォルト値を設定した policies/<name>.json をひな形として作成します。ユーザーに次の内容を確認します。
- 無効にする項目 — 使用している技術スタックに関係のない柱や追加項目（例：静的サイトでは
observabilityを無効にする）。 - 重要度を上げる項目 — 必須項目（例：
readme、codeowners）のimpactをhighまたはcriticalに変更する。 - 合格率のしきい値 — 一般的な組織の基準値：
0.7（緩め）、0.85（標準）、1.0（厳格）。 agentrc.config.jsonからポリシーを参照します。{ "policies": ["./policies/<name>.json"] }
apply <path-or-pkg>
agentrc readiness --json --policy <source> を実行し、assess スキル／ai-readiness-reporter エージェントに引き継いでレポートを再生成します。連結にも対応しています。
npx -y github:microsoft/agentrc readiness --json --policy ./org-baseline.json,./team-frontend.json
CI のゲーティング
ポリシーと --fail-level を組み合わせて、CI で最低成熟度レベルを適用します。
- run: npx -y github:microsoft/agentrc readiness --policy ./policies/strict.json --fail-level 3
詳細
JSON ポリシーでは、項目の無効化や上書き、しきい値の設定ができますが、新しい基準を追加することはできません。新しい検出ロジックが必要な場合は、AgentRC の TypeScript プラグインシステム（docs/dev/plugins.md）を案内してください。
運用ルール
- 柱を決して黙って無効にしないでください。 ユーザーが
observabilityの無効化を希望した場合は、必ず確認し、トレードオフを説明してください。 - 無効化よりも
impactの上書きを優先してください。 無効化すると不足が完全に見えなくなりますが、上書きすればレポートに表示したままにできます。 - 追加項目は有効のままにすることをおすすめしてください。 コストはかからず、スコアにも影響しません。
- ポリシーを重ねて使う方法を提案してください。 多くの組織では、ベースラインポリシーとチームごとの上書きを
--policy a.json,b.jsonで連結して使います。