Typefully 社媒排期助手

要解决的问题

Typefully 是做 Twitter/X 长帖串和社媒排期的工具，但手工打开网页粘贴草稿、逐个时间点设置发布时间，既打断写作流，也难自动化。把草稿创建、更新、删除这些动作交给 Agent 后，你可以在已有的内容管线里直接生成排期，不必在浏览器和编辑器之间来回切。

工作原理

该技能通过 OOMOL 连接的 Typefully 账号操作，底层调用 oo CLI 的 typefully connector。凭证由 OOMOL 服务端注入，你不需要自己保存或传 token，只需要 oo 已安装、已登录且完成过一次 Typefully 连接。

在调用前，先 oo connector schema 拉取权威的输入/输出 schema，再构造 --data 的 JSON payload；--data 可以传对象字符串或 @path/to/file.json，省略时发送 {}。返回结构是 { "data": ..., "meta": { "executionId": ... } }，执行 ID 在 meta.executionId 下，便于追踪。

可用的 8 个 action 覆盖了大部分排期场景：

• create_draft / update_draft：创建或更新某个 social set 下的草稿
• get_draft / list_drafts：按 ID 读取单个草稿，或带过滤条件列出草稿
• list_social_sets / get_social_set：枚举当前 API key 可见的 social set 及其详情
• delete_draft：按 ID 删除草稿
• get_current_user：确认当前 API key 对应的 Typefully 账号

执行顺序是：读参考文件确认 action 用途和精确命令 → 拉 live schema → 校验 payload → 运行。首次运行遇到认证或连接错误时，才回退到一次性的 setup 步骤。

适用边界与注意点

• 只读类 action（get / list）可以直接跑；create_draft 和 update_draft 会改变 Typefully 状态，运行前要和用户确认 payload 与预期效果。
• delete_draft 是破坏性操作，必须明确指定目标并取得显式批准。
• 不要主动执行 oo auth login 或打开连接 URL；只在命令确实因认证/连接失败时才走 setup。
• 遇到 scope_missing、credential_expired、app_not_found 时说明 Typefully 未连接或缺 scope；HTTP 402 / OOMOL_INSUFFICIENT_CREDIT 则需要先到 OOMOL 控制台补足额度。
• 该技能只覆盖 Typefully 的排期与草稿管理，不负责生成推文文案本身，也不直接发推；把它和内容生成环节组合起来才能形成完整流程。