前言¶
在飛書項目裏通過 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。
