飞书项目 MCP 工单管理手册
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @user_acfc9128/feishu-project-mcp-playbook 安装到 AI 助手中。
技能介绍
解决什么问题
在 Claude Code、Codex CLI、Cursor 或 VSCode Copilot 里接入飞书项目 MCP 后,常见痛点不是“能不能调用 API”,而是每次都要重新确认空间、工作项类型、字段 key、角色、枚举和关联项,导致对话冗长、成本高,也容易把未确认字段直接写入。
技能如何工作
该技能把飞书项目 MCP 的工单操作拆成可维护的本地上下文:先检查 feishu-project MCP 是否授权并连接,再读取业务上下文文件;创建时先调 get_workitem_field_meta,合并 schema 必填、流程必填和本轮字段;动态值优先取用户明确值、默认建议值、缓存候选值,缺失或要求最新时才 live query。确认后再调用 create_workitem、update_field、update_node、transition_node,并用 apply_patch 回写新缓存。
适用边界
它依赖飞书项目 MCP Server,不直接替代后端授权;字段、角色、枚举和关联项仍以空间配置为准。适合已有固定业务字段、角色、默认值的空间,不适合一次性随机探索陌生项目。节点流转前应查 get_transition_required,超时不等于失败,先回查状态。
使用场景
- 在 Cursor 里接入飞书项目 MCP 后,需要按固定字段创建需求工单并确认必填项。
- 某空间已有角色、枚举和关联项缓存,想减少每次 live query,只补缺口字段。
- 节点流工单流转前需要检查下一节点必填,并更新排期、估分、负责人。
- 用户给出负责人和发布时间,需要把这些值与默认建议分开确认后写入工单。
适合人员
- 在 Cursor 中接入飞书项目 MCP 的 AI 工具集成工程师,需要稳定创建工单并避免重复查字段。
- 维护项目空间字段映射的平台工程师,需要把角色、枚举和关联项沉淀为本地上下文。
- 用 AI 工具流转节点流工单的工程师,需要确认下一节点必填并更新排期、估分、负责人。
- 负责工单流程规范的技术负责人,需要固化必问字段和默认留空规则。