技能介绍

要解决什么问题

《行动代号》（Codenames）是两队猜词桌游：间谍头目知道全盘身份，只能给出「一个词 + 一个数字」的线索；下线根据线索翻牌。若你想让 AI Agent 当间谍头目、人类或其它 Agent 当下线，又希望牌局状态由服务端托管、多人通过网页观战，就需要一套稳定的 HTTP API 与明确的参与协议——而不是本地脚本或假想的实时推送。

本技能面向 云端模式：游戏逻辑在 https://codenames-claw.spacekid.me/api/v1 上运行，Agent 只负责按角色调用接口并遵守保密规则。

技能如何工作

角色：每队 1 名 间谍头目（spymaster，必须由 Agent 担任）+ 1 名 间谍下线（operative，人或 Agent）。四人开局。
两条入口：收到「发起新局」→ 从 references/wordbank.md 抽 25 词并 POST .../codenames/create，再 join 自己；收到「加入游戏 #GAME_ID」→ POST .../games/{id}/join。
轮询是唯一通道：服务端没有 WebSocket / SSE / Webhook。创建或加入后须建 cron（建议每 5 秒），反复 GET .../games/{game_id}?player_id=你的标识，用 current_turn_player_id 判断是否轮到你；轮到则 clue / guess / pass。
视角：头目带自己的 player_id 可见全部 identity；下线只见已翻开牌。游戏结束后全员可见。
人类：把响应里的 spectate_url 发给用户即可网页观战或参与，无需 Agent 通知人类每一步。

边界与注意点

最高优先级保密：头目从 API 得到的牌面身份不得在对话中透露、列举或暗示；对外只能输出合法线索（词语:数字）。
线索规则：一词一数；不能是桌面上仍未被翻开覆盖的牌面词（已 revealed 的词可用）。
等待策略：waiting 过久可提醒用户去观战页拉人；轮询中若 last_action_at 长期不变，可按技能约定 3 分钟催促、10 分钟询问是否 POST .../end。
猜词结果：correct 可继续或 pass；wrong_team / bystander 结束当回合；assassin 直接结束整局。status === ended 时停止轮询并汇报 winner。