Monday 工作区连接器

要解决的问题

Monday.com 的看板承载了项目与运营数据：board、group、item、column、update、form、doc、dashboard、team 都是状态的一部分。团队真正需要的是自动化：批量建板、移动条目、按列值查询、收集表单提交、导出操作日志。直接走 REST API 能做，但实践中很繁琐：要管 token 与权限范围，要为不同资源记不同的 mutation 结构，要处理分页差异，还要在脚本里拼对 JSON。

技能如何工作

这个技能把上述流程收敛成 契约驱动的执行模型。它通过 oo CLI 调用 Monday 连接器；凭证由 OOMOL 在服务端注入，模型侧不接触原始 token。技能暴露 64 个 action，按目的分为几类：

• 读取类：如 get_items、get_items_page / get_next_items_page、list_boards、list_board_columns、find_items_by_column_values、list_updates、list_docs、list_workspaces、list_teams、list_users。
• 写入类：如 create_board、create_item、create_group、create_column、change_simple_column_value、change_multiple_column_values、move_item_to_group、move_item_to_board、duplicate_item、set_item_description_content。
• 状态变更 / 生命周期类：如 activate_form、deactivate_form、archive_board、archive_item、delete_* 系列、update_board、update_column、update_dashboard、update_doc_name。
• 成员与组织类：如 add_users_to_board、add_teams_to_board、get_board_memberships、create_department、assign_department_members、list_audit_logs（后三类主要面向企业版账户）。

执行一个动作时，先查该 action 的契约，再用符合 input schema 的 JSON payload 运行。--data 可以传 JSON 对象字符串，也可以传 @path/to/file.json；省略时发送 {}。响应统一为 { "data": ..., "meta": { "executionId": "..." } }，追踪执行 id 时读 meta.executionId。技能还强调：不要主动跑 oo auth login 或打开连接 URL，只有命令真的报认证 / 连接错误时，才退回一次性 setup。

适用边界与注意点

读操作（get / list）可直接执行；创建、更新、发送、发布类动作会改变 Monday 状态，运行前必须和用户确认 payload 与影响；删除或移除类动作具有破坏性，必须先确认目标并拿到明确批准。

它不是 Monday API 的完整镜像，而是 64 个常用 action 的封装；每个 action 都指向参考文件，实际构造 --data 前还应用 schema 获取实时输入输出结构。表单、仪表盘、部门、审计日志等能力受账户类型与权限范围约束，企业版独占能力在非企业账户上不适用。计费与额度由 OOMOL 侧管理，额度不足时会得到 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT，需要先到 OOMOL 控制台充值。