ARWP（Agent-Ready Web Profile）證據與CI

ARWP 證據與 CI

在網站準備好之後，或當團隊希望 ARWP 品質隨時間維持穩定時，使用此技能。

工作流程

1. 建立合約。

   • 確認發布者預期保留哪些公開介面。
   • 使用 arwp assert 規定必要/可選/禁止的意圖與協定預期。
   • 避免使用通用的就緒分數。

2. 加入定期品質檢查。

   • 執行 arwp audit 以取得來源支援的搜尋/AI/代理建議。
   • 執行 arwp-growth 以建立優先改善待辦清單。
   • 若部署流程中包含本機 metadata 生成，請先執行網站建置/lint/測試。
   • 採用每週一次的檢查頻率，除非網站變更極快而需要其他頻率。

3. 為重要狀態擷取持久性證據。

   • 使用 arwp-receipt capture <url> 進行明確的高信賴度觀察。
   • 保留收據 ID 與不可變更的歷史記錄。
   • 區分 project-reference、independent-benchmark 等證據類別。
   • 絕不將對公開網站的觀察視為發布者已採用 ARWP 的證據。

4. 追蹤漂移。

   • 當介面選擇/標準身分重要時，使用解析器快照與 arwp drift。
   • 僅在明確合約違反時讓 CI 失敗，而非由於可選機會。
   • 保留負面結果與回歸，而非默默移除它們。

5. 謹慎附加來源追溯。

   • 僅在實際可取得時記錄 commit/工作流程/發布 ID。
   • 將 SBOM/證明證據僅連結到確切相符的工件。
   • 有效的 SHA-256 收據證明收據完整性，而非真實性、授權、發布者背書或安全性。

6. 保持平台指標外部。

   • Google Search Console 生成式 AI 指標、Bing AI 效能、ChatGPT 推薦資料以及類似僅由擁有者存取的 analytics 是證據輸入。
   • 儲存帶有日期與範圍的觀察前後記錄。
   • 在沒有受控證據的情況下，不得宣稱 ARWP 導致排名/引用變更。

7. 驗證 CI 品質。

   • 根據儲存庫政策固定/核准動作版本。
   • 保持權限為唯讀，除非需要特定寫入。
   • 絕不在工件、fixes、收據或日誌中放置機密。
   • 確保生成的公開工件在實際可行情況下以零差異再現。

建議的 GitHub Actions 輸出

發布工件，例如：

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• 解析器快照/漂移報告

使用工作摘要來呈現簡潔的 P0/P1 發現。不要因為純粹可選的功能（例如 Preferred Sources 或實驗性協定）缺失而導致建置失敗。