dkharlanau/agent-ready-web-profile

ARWP 证据与 CI 集成

在网站已准备就绪或团队希望长期保持 ARWP 质量稳定后，请使用此技能。

工作流程

1. 建立契约。

   • 明确发布方承诺保持可用的公共接口。
   • 使用 arwp assert 处理必需/可选/禁止的意图及协议预期。
   • 避免使用通用的就绪评分。

2. 添加周期性质量检查。

   • 运行 arwp audit 获取基于源的搜索/AI/代理推荐。
   • 运行 arwp-growth 创建优先改进待办列表。
   • 当本地元数据生成属于部署流程的一部分时，先运行网站构建/lint/测试。
   • 默认使用每周一次的频率，除非网站变化过快而需要其他频率。

3. 为重要状态捕获持久证据。

   • 使用 arwp-receipt capture <url> 获取明确的高证据观察结果。
   • 保留收据ID和不可变的历史记录。
   • 区分 project-reference、independent-benchmark 及其他证据类别。
   • 切勿将对公共站点的观察视为发布方采纳了 ARWP 的证据。

4. 追踪漂移。

   • 当接口选择/规范标识重要时，使用解析器快照和 arwp drift。
   • 仅在显式契约遭到破坏时导致CI失败，而非因可选机会而失败。
   • 保留负面结果和回归记录，而非静默删除它们。

5. 谨慎附加溯源信息。

   • 仅在提交/工作流/发布ID实际可用时记录它们。
   • 仅将SBOM/证明证据链接到完全匹配的工件。
   • 有效的SHA-256收据仅证明收据完整性，而非真实性、授权、发布方认可或安全性。

6. 将平台指标保持为外部指标。

   • Google搜索控制台的生成式AI指标、Bing AI性能、ChatGPT引用数据等仅所有者可用的分析数据属于证据输入。
   • 使用日期和范围存储前后观察结果。
   • 在没有受控证据的情况下，不得声称ARWP导致了排名/引用的变化。

7. 验证CI质量。

   • 根据仓库策略锁定/批准操作版本。
   • 保持权限为只读，除非需要特定的写入操作。
   • 切勿将秘密放置在工件、夹具、收据或日志中。
   • 确保生成的公共工件在实际可行的情况下能以零差异重现。

推荐的GitHub Actions输出

发布如下工件：

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

使用作业摘要提供简洁的P0/P1发现。不要因为纯粹的可选功能（如首选来源或实验性协议）缺失而导致构建失败。