用途：用于任何涉及 Tally.so 表单平台的任务，包括拉取提交/回答、读取表单结构或分析数据、以编程方式创建表单、管理工作区与组织成员，以及配置和验证 Webhook。需要持续处理提交时，优先使用 Webhook 而非轮询，因为 API 限制为每分钟 100 次请求。
主要能力：提供端点映射、精确的请求/响应结构、curl 命令行封装和 Webhook 签名验证。覆盖表单、提交、分析、工作区、组织成员与 Webhook。CLI 封装为 scripts/tally.sh，依赖 curl 与 jq，并自动加载密钥，支持 me、forms、questions <formId>、submissions <formId> completed 100、submission <formId> <submissionId>、metrics <formId>、form-create body.json、form-update <formId> body.json、form-delete <formId>、webhooks、webhook-create <formId> <url> [signingSecret]、raw GET /users/me 等命令。
认证与用法：在 Tally 面板 Settings → API keys → Create API key 获取密钥，格式为 tly-xxxx，通过 Authorization: Bearer tly-xxxx 发送。密钥继承创建用户的权限，无细粒度作用域；创建工作区需要 Pro。密钥应存放在仓库之外，CLI 先读取 $TALLY_API_KEY，否则从 ~/.claude/auth/tally.env 读取 TALLY_API_KEY=，可用 $TALLY_ENV_FILE 覆盖路径，切勿完整打印密钥。使用前先阅读 references/api-reference.md 与 references/webhooks.md，以及 references/examples/create-form.json。官方 MCP 服务器也可用，若已连接，交互任务优先用 MCP，脚本、批量同步、Webhook 配置和签名验证则用本技能的 REST/CLI 路径。
限制与注意：分页有 offset（page/limit，检查 hasMore）和 cursor（afterId）两种，大型回填建议用 afterId。提交答案按问题类型区分，需将 responses[].questionId 关联 questions[]，仅出现已回答的问题。REST 与 Webhook 结构不同：REST 返回 responses[]（answer/formattedAnswer），Webhook 发送 data.fields[]（label/type/value，选项在 options[]）。速率限制 100/分钟，超限返回 429，可批量 limit 至 500 或改用 Webhook。DELETE /workspaces/{id} 会删除其全部表单，DELETE /forms/{id} 会将表单移入回收站，执行前需确认。Webhook 处理器应保持幂等（按 eventId/submissionId 去重），投递可能重试。验证签名需对原始请求体字节做 HMAC-SHA256，不要对重新序列化的 JSON 计算。