这是一条面向外部仓库的公开接入路径。

外部仓库结构

先按这套目录准备仓库

.github/
  answerlens/
    brand.yaml
    competitors.yaml
    prompts.yaml
  workflows/
    answerlens.yml

这就是 examples/consumer-repo 使用的同一套目录结构。

文件职责

每个文件分别负责什么

• brand.yaml：定义产品名、域名、proof-page 提示，以及可选的 site_display_name。
• competitors.yaml：声明你真正要打进去的竞品集合。
• prompts.yaml：写给真实买家与评估场景的比较、引用和推荐问题。
• answerlens.yml：把同一套 artifact 契约跑进 CI 的 GitHub Action workflow。

可复制来源

可直接复制的 starter 文件

• brand.yaml
• competitors.yaml
• prompts.yaml
• answerlens.yml

审阅流

先按这个顺序审阅

1. share-summary.md
2. scorecard.md
3. recommendations.md

看完这三份之后，再用 pr-snippet.md 处理 GitHub 文案，用 run.json 处理机器可读元数据。

公开证明

先看这次 starter 示例运行

示例站点： 示例 Product public site

这个公开示例会把 consumer-repo starter bundle 跑在稳定 fixture 上，让外部采用者在接自己站点之前，先看清最终产物会是什么样。

• share-summary.md
• scorecard.md
• recommendations.md

激活路径

把它接进真实仓库时怎么走

1. 先跑 5 分钟真实站点审计，如果你还没做过这一步。
2. 把 starter 文件复制到你要审计的仓库里。
3. 再进入 GitHub Action 路径，前提是本地运行已经足够可审阅。

这样 starter bundle 才会继续保持“准备好接入”的证明资产，而不是被误读成另一套独立产品。

相关证明页面

这页应该和哪些公开页一起看

• 示例页：先看 live demo 的 artifact 组合。
• 文档页：继续看 activation 参考、评分说明和规范 Markdown。
• 集成页：看 starter bundle 如何嵌进 GitHub-native 工作流。
• 发布页：把 release assets 当作第二个公开入口。