dkharlanau/agent-ready-web-profile

ARWP エビデンスとCI

サイトの準備後、またはチームがARWPの品質を長期間安定させたい場合に、このスキルを使用します。

ワークフロー

1. 契約を確立する。

   • パブリッシャーが利用可能であり続けると期待する公開インターフェースを特定する。
   • 必須/任意/禁止のインテントおよびプロトコル期待値には arwp assert を使用する。
   • 普遍的なレディネススコアは避ける。

2. 定期的な品質チェックを追加する。

   • ソースに基づく検索/AI/エージェント推奨事項には arwp audit を実行する。
   • 優先順位付けされた改善バックログを作成するには arwp-growth を実行する。
   • ローカルメタデータ生成がデプロイの一部である場合は、最初にサイトのビルド/リンター/テストを実行する。
   • サイトの変更が非常に頻繁で別のサイクルが正当化されない限り、週次サイクルを使用する。

3. 重要な状態に対する永続的なエビデンスを取得する。

   • 明示的な高エビデンス観測には arwp-receipt capture <url> を使用する。
   • レシートIDと不変の履歴レコードを保持する。
   • project-reference、independent-benchmark、およびその他のエビデンスクラスを分離する。
   • 公開サイトの観測を、パブリッシャーがARWPを採用した証拠として扱わない。

4. ドリフトを追跡する。

   • インターフェース選択/正規のIDが重要な場合は、リゾルバースナップショットと arwp drift を使用する。
   • 明示的な契約違反ではCIを失敗させるが、任意の機会では失敗させない。
   • 否定的な結果や回帰を黙って削除せずに保持する。

5. 出典情報を慎重に添付する。

   • コミット/ワークフロー/リリースIDは、実際に利用可能な場合にのみ記録する。
   • SBOM/アテステーションのエビデンスは、正確に一致するアーティファクトにのみリンクする。
   • 有効なSHA-256レシートはレシートの整合性を証明するものであり、真実性、許可、パブリッシャーの承認、またはセキュリティを証明するものではない。

6. プラットフォームメトリクスは外部に保持する。

   • Google Search Consoleの生成AIメトリクス、Bing AIパフォーマンス、ChatGPT参照データなど、オーナーのみがアクセスできる分析情報はエビデンスの入力値である。
   • 日付と範囲を付けて、前後の観測結果を保存する。
   • 管理されたエビデンスなしに、ARWPがランキングや引用の変化を引き起こしたと主張しない。

7. CI品質を検証する。

   • アクションバージョンはリポジトリポリシーに従って固定/承認する。
   • 特定の書き込みが必要でない限り、権限は読み取り専用に保つ。
   • シークレットをアーティファクト、フィクスチャ、レシート、ログに決して配置しない。
   • 生成された公開アーティファクトが、実用的な範囲でゼロ差分で再現できることを確認する。

推奨されるGitHub Actionsの出力

次のようなアーティファクトを公開する：

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• リゾルバースナップショット/ドリフトレポート

ジョブサマリーには簡潔なP0/P1の結果を使用する。Preferred Sourcesや実験的プロトコルなどの純粋にオプション機能が欠けているためにビルドを失敗させない。