前言¶
在飞书项目里通过 MCP 让 AI 建单、改单、查关联时，常见摩擦不是「连不上」，而是每次都要重新对齐空间里的字段名、枚举值、角色和默认值。人工查一遍配置再口述给模型，既慢也容易填错。
下面介绍 SkillHub 上的社区 Skill「飞书项目 MCP 对接」（@user_acfc9128/feishu-project-mcp-playbook）。它不替代飞书项目 MCP 本身，而是在 MCP 已连接的前提下，引导 Agent 优先读取你本地维护的业务上下文，把字段映射、角色、默认值和常用候选项沉淀下来复用。
这是什么¶
一句话定位： 配合已安装的 feishu-project MCP，用本地业务上下文文件加速工单类操作的 Agent Skill。
维护方： SkillHub 社区发布者 user_acfc9128，坐标 @user_acfc9128/feishu-project-mcp-playbook，当前版本 1.0.0，分类为 ai-agent，标签 requires_api_key=false（Skill 本身不要求单独配置 API Key）。
解决什么问题： 连接飞书项目 MCP 之后，避免 Agent 每次从零查字段、查枚举、查关联项；通过持续更新上下文，让后续工单操作更贴近你所在空间的实际配置。
官方说明与安装入口：
- Skill 页面：https://www.skillhub.cn/skills/user_acfc9128/feishu-project-mcp-playbook
- API 索引：https://api.skillhub.cn/user_acfc9128/feishu-project-mcp-playbook
核心功能¶
依据 SkillHub 页面与抓取资料，可核实的能力如下：
- 前置依赖明确： 使用前需在 AI 工具中安装并连接飞书项目的
feishu-projectMCP；官方帮助文档见 https://project.feishu.cn/b/helpcenter/1ykiuvvj/wzb3ycsc。 - 本地业务上下文： Skill 会基于你在本地维护的上下文文件工作，优先复用其中的字段映射、角色配置、默认值和常用候选项。
- 面向工单管理： 设计目标是在 MCP 可用时，更快完成飞书项目中的工单相关操作（创建、更新、查询等具体能力由 MCP 与飞书项目侧提供，本 Skill 侧重「怎么用对字段与业务约定」）。
安装与启用¶
安装分两步：先接通飞书项目 MCP，再安装本 Skill。
1. 连接 feishu-project MCP¶
按飞书项目帮助中心文档，在你的 AI 客户端中完成 feishu-project MCP 的安装与连接：https://project.feishu.cn/b/helpcenter/1ykiuvvj/wzb3ycsc。
未连接 MCP 时，本 Skill 无法发挥「快速管理工单」的作用。
2. 安装 Skill（SkillHub）¶
SkillHub 官方给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_acfc9128/feishu-project-mcp-playbook。
若本机已有 skillhub CLI，可将 Skill 安装到当前 Agent 识别的 skills 目录（安装时需使用 --dir，否则默认落在 ./skills/ 可能不会被客户端加载）：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 安装文档执行完整安装（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 示例（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @user_acfc9128/feishu-project-mcp-playbook --dir <skills 目录>
SkillHub 文档中常见的 skills 目录包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。
3. 维护业务上下文文件¶
官方建议：根据自己的飞书项目空间配置，持续更新本地业务上下文文件。上下文越完整，Agent 越能稳定复用字段映射与业务默认值，减少反复查询。
具体文件名、目录结构以 Skill 包内 SKILL.md 为准；安装完成后可在对应 skills 目录下打开该文件查看约定。
典型用法¶
可复现的流程与官方描述一致，不涉及未给出的命令或配置项：
- 在 AI 工具中完成
feishu-projectMCP 连接。 - 安装并启用
@user_acfc9128/feishu-project-mcp-playbook。 - 按空间实际情况编写或更新本地业务上下文（字段映射、角色、默认值、常用候选项等）。
- 在对话中提出工单相关需求（例如创建、更新、查询某类工作项）；Agent 在 Skill 指引下优先读取上下文，再通过 MCP 调用飞书项目接口。
SkillHub 页面未提供固定的示例提示词或截图级案例；实际字段名与工单类型以你的空间配置为准。
适用场景与注意¶
适合谁
- 已在用或计划用飞书项目 MCP，且工单字段、枚举、角色较多、变动不频繁的团队。
- 希望把「空间怎么配」沉淀成文件，让多个同事或多次会话共用同一套业务约定的人。
限制与注意
- 本 Skill 不能替代 MCP：必须先按飞书文档连接
feishu-projectMCP。 - 上下文文件需要人工维护；空间配置变更后应同步更新，否则 Agent 可能仍按旧映射操作。
- 工单能否创建成功、权限范围等，取决于飞书项目账号、空间权限与 MCP 能力，而非 Skill 单独决定。
- Skill 为 community 来源，使用前可在 SkillHub 页面查看版本与说明；截至资料抓取时，页面显示评分约 100000，下载 1552，安装 85（以 SkillHub 实时数据为准）。
结尾¶
「飞书项目 MCP 对接」把飞书项目 MCP 的通用能力，和你团队自己的字段与角色约定绑在一起：MCP 负责连通，本地上下文负责少查、少错，Skill 负责让 Agent 按这套约定干活。
需要安装或更新时，打开 SkillHub 官方页面即可：https://www.skillhub.cn/skills/user_acfc9128/feishu-project-mcp-playbook。
