菜单
飞书文档同步。在以下场景触发： 1. 用户说 "同步到飞书"、"推送到飞书" 2. 用户说 "从飞书拉取"、"同步飞书变更" 3. 用户说 "检查飞书同步状态" 4. 用户提到文档需要同步到飞书知识库 支持双向同步：本地 → 飞书，飞书 → 本地
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | feishu-sync |
| description | 飞书文档同步。在以下场景触发： 1. 用户说 "同步到飞书"、"推送到飞书" 2. 用户说 "从飞书拉取"、"同步飞书变更" 3. 用户说 "检查飞书同步状态" 4. 用户提到文档需要同步到飞书知识库 支持双向同步：本地 → 飞书，飞书 → 本地 |
管理本地文档与飞书知识库的双向同步。
飞书同步涉及两种 MCP：
| MCP | 用途 | 适用操作 |
|---|---|---|
feishu-official | 文档和 Wiki 操作 | create-doc, fetch-doc, search-doc, list-docs, get-comments, add-comments |
feishu | 多维表格及其他操作 | bitable, calendar, task, im 等 |
文档/Wiki 同步使用 *feishu-official*，多维表格操作使用 **feishu**。
feishu-official):.mcp.json 中已配置 feishu-officialfeishu):.mcp.json 中已配置 feishu/mcp → feishu → Authentication 完成授权.claude/context/feishu-config.md 中）当用户说"同步到飞书"时：
📤 将同步以下文档到飞书:
docs/product/prd-order.md → 飞书 Wiki/产品文档/订单模块PRD
docs/tech/tech-order.md → 飞书 Wiki/技术文档/订单模块技术方案
是否继续？[确认] [选择] [取消]
检查同步状态
读取 .claude/context/feishu-map.md 获取文档到飞书的映射：
执行同步
使用 feishu_create_doc 或 feishu_update_doc 工具
更新映射
同步完成后更新 feishu-map.md：
| 本地路径 | 飞书 Token | 最后同步 | 状态 |
|----------|-----------|----------|------|
| docs/product/prd-order.md | doxcnXXXX | 2026-03-09 14:00 | synced |
当用户说"从飞书拉取"时：
获取飞书变更
使用 feishu_list_wiki_nodes 获取 Wiki 节点列表
对比 feishu-map.md 中的 最后同步 时间
报告变更
📥 检测到飞书变更:
更新的文档:
- 订单模块PRD (更新于 2026-03-09 13:00)
新增的文档:
- 支付模块PRD (创建于 2026-03-09 12:00)
是否拉取？[全部] [选择] [取消]
执行拉取
使用 feishu_fetch_doc 获取文档内容
保存到对应的本地路径
更新映射
更新 feishu-map.md 中的同步时间
当用户说"检查同步状态"时：
📊 飞书同步状态:
已同步 (5):
✅ docs/product/prd-order.md → 订单模块PRD
✅ docs/tech/tech-order.md → 订单模块技术方案
待同步 (2):
⏳ docs/product/prd-payment.md (本地更新于 2026-03-09 14:00)
⏳ docs/test/test-order.md (新建，未同步)
冲突 (1):
⚠️ docs/product/prd-user.md (飞书有更新)
是否同步待同步文档？[是] [否]
默认映射规则（可在 feishu-config.md 中自定义）：
| 本地目录 | 飞书 Wiki 节点 |
|---|---|
docs/product/ | 产品文档/ |
docs/tech/ | 技术文档/ |
docs/test/ | 测试文档/ |
docs/meetings/ | 会议纪要/ |
当检测到冲突时（本地和飞书都有更新）：
⚠️ 冲突检测: docs/product/prd-user.md
本地版本: 2026-03-09 14:00 (用户A)
飞书版本: 2026-03-09 13:30 (用户B)
请选择:
[1] 保留本地版本 (覆盖飞书)
[2] 使用飞书版本 (覆盖本地)
[3] 手动合并 (显示 diff)
[4] 跳过
选择手动合并时，显示两版本的差异：
--- 本地版本
+++ 飞书版本
@@ -10,7 +10,7 @@
-## 功能需求
+## 业务需求
# 飞书文档映射
> 自动维护，请勿手动编辑
| 本地路径 | 飞书 Token | 飞书标题 | 最后同步 | 状态 | MD5 |
|----------|-----------|----------|----------|------|-----|
| docs/product/prd-order.md | doxcnXXXX | 订单模块PRD | 2026-03-09T14:00:00Z | synced | abc123 |
| 错误 | 处理 |
|---|---|
| 飞书 Token 无效 / 过期 | 提示运行 "飞书授权" 或 "检查飞书状态"，引导使用 feishu-connect |
| feishu-official UAT 无效 | 提示运行 "飞书授权" 重新获取 UAT Token |
| feishu Token 无效 | 提示运行 /mcp → feishu → Authentication 重新授权 |
| Wiki 权限不足 | 提示检查应用权限配置 |
| 网络超时 | 重试 3 次，失败后提示 |
| 文档过大 | 提示拆分文档 |
当遇到授权相关错误时：
⚠️ 飞书授权问题
检测到授权失效或未授权。
请运行以下命令解决:
- "飞书授权" - 引导完成授权流程
- "检查飞书状态" - 查看当前授权状态
或者直接说 "找 feishu-connect" 获取帮助
支持批量操作：
用户: "同步所有待同步文档"
用户: "同步 docs/product/ 下的所有文档"
用户: "拉取飞书所有更新"
在 feishu-config.md 中配置：
auto_sync:
on_commit: true # 提交时自动同步 status=approved 的文档
on_session_start: true # 会话启动时检查飞书变更
初始化工作空间时会自动配置 post-commit hook：
# .git/hooks/post-commit
# 检测本次提交中 status=approved 的 .md 文件
# 如果有已批准的文档，提示用户可以同步到飞书
工作流程：
status: approved 的 .md 文件手动配置 Git Hook：
如果需要手动配置，复制 scripts/post-commit 到 .git/hooks/：
cp scripts/post-commit .git/hooks/
chmod +x .git/hooks/post-commit
工作空间初始化。在以下场景触发： 1. 用户说 "初始化项目"、"初始化工作空间" 2. 用户说 "新建项目"、"创建项目" 3. 用户在一个空目录中说 "开始" 4. 用户需要快速搭建项目结构 一键初始化 Claude Code Native 工作空间，支持飞书集成配置。
里程碑提交管理。在以下场景触发： 1. 完成一个重要功能模块 2. 文档从 draft 变为 approved 3. 项目阶段转换（需求 → 设计 → 开发） 4. 用户说 "创建里程碑"、"提交里程碑" 5. 用户说 "总结这个阶段" 帮助用户在关键节点创建有意义的 Git 提交，记录项目演进历史。
工作空间初始化。在以下场景触发： 1. 用户说 "初始化项目"、"初始化工作空间" 2. 用户说 "新建项目"、"创建项目" 3. 用户在一个空目录中说 "开始" 4. 用户需要快速搭建项目结构 一键初始化 OpenWork Native 工作空间，支持飞书集成配置。
文档工作流。在以下场景触发： 1. 用户说 "创建 PRD"、"写技术方案"、"写测试方案" 2. 用户说 "提交评审"、"发布文档" 3. 用户说 "检查文档"、"更新文档状态" 4. 用户提到文档类型关键词（PRD、技术方案、测试用例等） 支持文档创建、评审、状态流转、模版应用。
飞书 MCP 连接管理。在以下场景触发： 1. 用户说 "飞书连接"、"连接飞书"、"飞书配置" 2. 用户说 "飞书状态"、"检查飞书连接" 3. 用户说 "飞书授权"、"授权飞书" 4. 用户说 "飞书 token"、"刷新飞书 token" 5. 会话启动时自动检测飞书 MCP 状态 管理两个飞书 MCP 的连接状态、授权流程和 Token 刷新。
实施交付流程 SOP。在以下场景触发： 1. 用户说 "开始新项目"、"创建实施项目" 2. 用户说 "下一步做什么"、"当前阶段" 3. 用户说 "项目流程"、"实施流程" 4. 用户询问项目进展或阶段 5. 项目类型为 implementation 定义标准的实施交付流程和各阶段交付物。