飞书项目 Meegle CLI 操作指南v1.0.19

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向需要通过命令行批量或自动化操作飞书项目（Meegle）数据的用户与开发者。基于 Meegle CLI 提供完整的项目空间管理、工作项全生命周期操作（创建、查询、批量获取、MQL 检索、更新）、节点流与状态流工作流流转、附件上传下载、视图查询、工时排期获取、评论交互等能力。输出语言跟随用户输入，默认中文。特别覆盖 Meegle CLI 特有的客户端封装命令（如 +batch-get、+upload、+download）以及读写协议不对称、逻辑字段聚合等实际使用中的关键心智模型，帮助用户避开常见陷阱并正确构造调用参数。

技能包含

• SKILL.md（本文件）：技能主说明，含各命令参数表、调用约束与前置要求
• NOTICE.md：相对上游 meegle-cli 的改动清单
• references/api-examples.md：各命令的调用示例
• references/auth-guard.md：授权流程说明（所有业务命令前必须执行）
• references/cli-guide.md：CLI 命令结构、参数传递、命令发现、退出码指南
• references/attachment.md：附件上传/下载的两步流程与一键封装命令详解
• references/error-handling.md：错误处理参考
• references/field-value-extras.md：字段值格式补充说明
• references/misc.md：工时记录查询、团队列表、评论列表等杂项命令参数
• references/mql-syntax.md：MQL 查询语法详解
• references/performance.md：性能相关参考
• references/rich-text-editor-markdown-syntax.md：富文本评论的 Markdown 语法
• references/sop-create-workitem.md：创建工作项的标准操作流程
• references/sop-transition-node.md：节点流转操作指南
• references/sop-transition-state.md：状态流转操作指南
• references/sop-update-workitem.md：更新工作项的详细示例（含 group_type 逻辑字段）
• references/url-kinds.md：URL 类型说明
• references/view.md：视图搜索与固定视图管理
• references/wbs.md：WBS 相关参考
• references/workflow.md：工作流辅助命令（状态流转列表、节点字段元数据等）
• references/workitem.md：工作项元数据查询命令参数（类型、字段、角色、创建字段）

核心能力

• 工作项全生命周期管理：创建、单条/批量查询、MQL 检索、字段与角色更新、操作记录追溯
• 工作流节点与状态流转：节点完成/回滚、状态流转、节点详情获取、节点排期与负责人调整
• MQL 数据查询：使用类 SQL 语法按条件检索工作项，支持分组分页与会话翻页
• 附件上传下载：通过预签名 URL 机制实现大文件传输，提供 +upload/+download 一键封装
• 视图与工时数据获取：按视图 ID 拉取工作项列表，查询人员排期与工作量明细（支持多人多批次）
• 人员信息解析：将姓名/邮箱批量转换为 userkey，支持 MQL 中 current_login_user() 快捷引用
• Meegle CLI 特有心智模型：逻辑字段聚合（如 group_type）、读写协议不对称、客户端封装命令（+ 前缀）的正确使用

应用场景