// Feishu document writing skill. Handles known API pitfalls (block ordering, unsupported formats). Activate when writing content into Feishu docs or creating structured documents.
飞书多 Agent 系统搭建指南。当用户要求创建新的功能 Agent、配置飞书群聊绑定、 搭建多 Agent 协作系统时激活此 skill。 触发词：创建 agent、新建 agent、添加 agent、create agent、多 agent、飞书绑定。
Git 工作流规范。管理分支、commit、PR 的标准流程。 用户发送 /git 或涉及版本控制操作时触发。
Delegate tasks to agents asynchronously. Triggers on "让XX做", "delegate to", "assign to", "派发", "布置任务".
代码审查技能。用户发送 /review 或要求 review 时触发。 自动检查代码质量、安全问题、架构建议。
多项目管理和目录切换。用户发送 /repo 时列出项目，选择后切换工作目录。 适用于 coder agent 同时维护多个代码仓库的场景。
跨 Agent 通信。当用户说"问XX"、"让XX做"、"发给XX"、"check agent status"时使用。
| name | feishu-doc-writer |
| description | Feishu document writing skill. Handles known API pitfalls (block ordering, unsupported formats). Activate when writing content into Feishu docs or creating structured documents. |
飞书原生 MD 解析，支持表格，无 block 乱序。
流程： 本地写 .md → 上传素材 → 创建导入任务 → 轮询结果 → 加权限
# Step 1: 上传
POST /drive/v1/medias/upload_all → file_token
# Step 2: 导入
POST /drive/v1/import_tasks
body: { file_extension: "md", file_token, type: "docx",
file_name: "标题", point: {mount_type: 1, mount_key: ""} }
→ ticket
# Step 3: 轮询
GET /drive/v1/import_tasks/{ticket} → doc_token, url
# Step 4: 加权限
POST /drive/v1/permissions/{doc_token}/members?type=docx
body: { member_type: "openid", member_id: "ou_xxx", perm: "full_access" }
完整 Python 脚本：references/md-import.py
# 用法
python3 references/md-import.py report.md "报告标题"
# 或设置环境变量
FEISHU_APP_ID=cli_xxx FEISHU_APP_SECRET=xxx python3 references/md-import.py report.md "标题"
1. feishu_doc create → doc_token
2. feishu_perm add → 授权用户
3. feishu_doc append × N → 逐章节写入
**模型 A — ✅ 通过**
- Token 消耗: 46,817
- 评价: 稳定可靠
| 场景 | 方案 |
|---|---|
| 长文档 / 含表格 / 严格顺序 | ⭐ MD 导入 |
| 短文档 / 追加 / 修改已有文档 | feishu_doc |
| 替换整篇 | feishu_doc write（单次调用无乱序） |
原则： 章节自包含、结论前置、必须附原始证据、因果链完整。
| Error | Cause | Fix |
|---|---|---|
| 400 on append | Markdown 表格 | 用 MD 导入或列表替代 |
| Block 乱序 | 多次 append | 用 MD 导入 |
| 403 | 权限不足 | 检查 docx:document scope |
| 99992402 on import | 缺 point 字段 | 加 point: {mount_type:1, mount_key:""} |
详细消息格式规范见 references/feishu-message-format.md。