技能介绍

要解决什么问题

团队把目标、KPI、举措和任务拆在多个工具里时，代理很难判断「现在该动哪一块」：KPI 掉速、举措卡住、里程碑逾期往往彼此相关，但上下文散落在各处。Atoll 用 Goal → KPI → Initiative → Issue 的推理链把策略和执行绑在一起；本技能教代理在用户明确要做 Atoll 相关工作，或当前任务确实依赖 Atoll 数据时，如何安全、可审计地读写这些数据。

技能如何工作

认证与范围：所有请求带 Authorization: Bearer sk_atoll_...，密钥按组织（org）授权；OpenClaw 场景优先把 ATOLL_API_KEY、ATOLL_ORG_ID 等写在 skill 配置里，而不是把密钥写进对话或文件。自检应打 org 级接口（例如 issues），单独 GET /api/auth/me 无法发现 ATOLL_ORG_ID 为空导致的误报 401。
CLI 优先：日常建单、评论、heartbeat、策略搭建建议走 atoll CLI；机器可读输出用 --json，列表结构含 items、total、nextOffset 等字段。多凭证环境可用 auth profiles，并始终显式带上 org。
Heartbeat 代理循环：atoll heartbeat --json 汇总目标剩余时间、KPI pace（pace_needed vs pace_actual）、举措进度、分配给代理的工作，以及按严重度排序的 signals（如 kpi_off_pace、initiative_stalled）。典型循环：拉 heartbeat → 读信号 → 结合 KPI/举措状态推理最高杠杆动作 → 执行（解阻、快照、建单）→ 重复。
策略链与体检：可用 goals/KPIs/initiatives/issues 端点或 CLI 搭建链路；strategy audit 返回带 suggested_fix 的结构化 findings，用于修补「举措无目标」「KPI 无目标值」等结构性问题，与 heartbeat 的「今天做什么」互补。
进阶路径：CLI 未覆盖的端点可走 REST；需要远程 MCP 时用 @atollhq/mcp-server（POST /mcp + Bearer）。KPI 第三方 HTTP 同步只能起草 GET、HTTPS、JSON 的 draft，且目标 host 须已由管理员 allowlist，密钥只能在 Atoll 后台录入。

边界与注意点

默认只读，创建/更新/删除需用户明确要求；破坏性操作前先确认，删任务优先 archive。不要把 $ATOLL_API_KEY 或第三方 token 打进 prompt、issue 描述或评论。首跑 setup wizard 的 setup-scoped key 只能改 setup proposal，不能代用户直接落库或审批。未安装本技能时，应提示用户先安装或改用 Atoll CLI/MCP。