OOMOL Shortcut 连接器

它解决什么问题

直接调用 Shortcut API 做自动化，团队通常得自己处理 API token 的保存、轮换和权限范围，再为每个场景写一遍胶水代码。oo-shortcut 把 Shortcut 连接器包在 oo CLI 后面，凭证由 OOMOL 服务端注入，Agent 只需要按输入 schema 拼 JSON payload，全程不用接触原始 token。

核心能力与工作方式

• 共 15 个动作，覆盖 epic、story、member、project、workflow 的 create / get / update / list，外加 search_stories。
• 执行前先用 oo connector schema 拉取权威的输入/输出契约，不要凭猜测拼 payload。
• 用 --data 传入 JSON 对象字符串或 @path/to/file.json，不传则发送 {}。
• 返回结构固定为 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId 下。
• 每个动作的详细命令和用途写在对应的参考文件里，先读参考文件再拉取实时 schema。

边界与注意点

• 读取类动作（get / list / search）可以直接运行；create / update / send / post 会改变 Shortcut 状态，执行前必须向用户确认完整 payload 和预期效果。
• delete / remove 是破坏性操作，必须先确认目标对象并获得明确批准。
• 首次配置是一次性的：只在命令真的因认证或连接错误失败时才去登录或重连，不要每次调用都主动执行 oo auth login。
• 字段是「首轮支持字段」，具体可用范围以实时 schema 为准。