用途
Goal coverage 用于发现公司目标与工作区已部署资源之间的差距。它以周为单位运行部署的智能体，读取公司目标（若 plan/company-plan.md 存在则从其中的“## The one goal”段落派生，否则通过 COVERAGE_GOAL 环境变量提供），并对比工作区当前运行的 play、agent、model 和连接器，用工作区自身的数字说出注意到的问题，例如“你有 4,200 个账户，但没有任何评分”。每条观察附带修复它的管线。目标是对照目标排名每条建议，并引用目标原文。
主要能力
- 每周读取目标，盘点工作区现有资源，给出最多五条建议，每条附数字依据。
- 生成覆盖文件
cadence/coverage/<YYYY-Www>.md，通过一个标题为[cadence] coverage YYYY-Www的拉取请求提交。文件中包含目标原文、当前运行内容以及带status: open的建议。 - 审查者可在合并前将建议状态改为
status: declined: <reason>，该拒绝会被记住：被拒绝的建议四周内不再出现；持续开放三周的建议会被视为噪音丢弃。 - 同时将同样的建议发送到指定 Slack 频道，并链接拉取请求。
- 每次运行从
https://raw.githubusercontent.com/getcargohq/gtm-skills/main/catalog.json获取目录，仅建议目录中存在的管线；获取失败则不提出任何建议。 - 已安装的判断基于三个信号：检出目录中的
infra/<name>/、以管线命名的 workspace 文件夹、或匹配名称的已部署 play/agent slug。已安装即视为已覆盖，不论其运行状况。 - 工作区读取只读，写路径仅为拉取请求和一个锁定的 Slack 频道。
- 不安装、不部署、不启用任何建议内容；安装命令写在文件中，由人决定是否执行。
使用方式
项目安装：在包含 cargo.json 的项目文件夹中运行 cargo-ai project add cookbook/goal-coverage，示例写入 infra/goal-coverage/，过程写入 .claude/skills/goal-coverage/。若尚无项目，运行 cargo-ai project init <dir> --cookbook goal-coverage && cd <dir> && npm install。若已在项目的 .claude/skills/ 中读到该文件，说明安装已完成，从第 2 步开始。CLI 版本过旧时，手动将文件夹复制为同级目录。
适配步骤：与已有声明协调，若项目已有 Anthropic、GitHub 或 Slack 连接器，重新绑定导入并删除副本，避免同一 slug 冲突。按顺序处理“不应更改”“可以更改”“将会被询问”部分，在副本中记录改动与原因到 ## Decisions 段。
检查与部署：运行 node --import tsx evals/contract.mjs，然后 npm run check && cargo-ai project plan 查看 diff，仅在明确同意后执行 cargo-ai project deploy。不要对非空目录执行 cargo-ai project init --force。
验证：不等到周二，手动运行一次智能体，逐行核对完成条件并附证据。
适用场景
- 团队希望无需了解目录即可知道还缺什么能力，每周获得基于工作区数据的建议。
- 需要以拉取请求方式审查和采纳管线建议，并保留拒绝记忆的组织。
- 希望 Slack 通知覆盖不常打开 GitHub 的读者。
- 需要控制建议数量（调整“最多五条”）、改为月度运行、或仅 Slack 通知等变体。
限制
- 不评判已有工作的进展（由 weekly-planning 负责）或已部署 play 的故障（由 workspace-health 负责）；已安装即视为覆盖。
- 建议仅限实时获取的目录中存在的管线；目录获取失败则不提建议。
- 不安装、部署或启用任何建议；安装命令存在但需人工执行。
- 每条观察必须带读取到的数字，无数字的观察不可接受。
- 默认每周运行一次，成本为通过 Anthropic 连接器计费的 LLM token；工作区读取为 API 调用不计费，Slack 每周一次连接器动作。
- 若采用仅 Slack 无拉取请求的变体，将丧失拒绝记忆，被拒建议会每周重复出现。