# Course Lark Delivery

> 把最终课程定位、课纲、章节稿和审校意见写入可协作的飞书文档，支持原位更新、保留原稿创建同级文档、目标文件夹批量建文档、精确 block 评论和可选 CEO 审查队列，并执行写后回读。Use when the user says 交付飞书文档、回写课程稿、在飞书上协作、给课程稿加评论、创建课程文档，或 Course Producer 进入 lark_delivery 阶段。

- Skill: `ivor-ncut/course-lark-delivery` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ivor-ncut/course-lark-delivery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ivor-ncut/course-lark-delivery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Ivor-NCUT (https://skillmd.com/u/ivor-ncut)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ivor-ncut/course-lark-delivery

---


# 飞书课程协作交付

只负责飞书对象解析、写入、评论和回读，不改写课程内容。执行任何命令前遵循 `lark-shared`；文档、Wiki、Drive、妙记分别调用对应 Lark Skill，不自建 API 客户端。

## 解析输入

1. 用 `lark-cli auth status --json --verify` 检查当前用户身份；需要访问用户资源时显式使用 `--as user`。
2. 对任意 URL 先运行 `lark-cli drive +inspect --url '<url>' --as user --format json`。Wiki URL 必须保存 `wiki_node.space_id`、`node_token`、底层 `obj_token` 与 `obj_type`，不能把 Wiki token 当文档 token 猜用。
3. 妙记 URL 从路径取 `minute_token`，用 `minutes +detail --minute-tokens <token> --transcript` 读取转录；摘要只作导航。
4. 写入前读取目标现状与标题，记录原对象、父节点/文件夹和计划操作。若用户未授权覆盖已有正文，停在写入前并说明影响。

## 三种交付模式

### 原位更新

适用于用户明确要求直接编辑当前稿。用 `docs +update` 写入最终正文；局部精修使用 XML block 命令，整篇明确覆盖时才用 `overwrite`。覆盖前保留原文指纹或版本信息。

批量原位更新时使用评论保留事务：

1. 写前逐文档保存 URL/token、revision、Markdown/XML 正文、正文 SHA，以及全部评论
   thread id、锚点、回复和解决状态，形成 `.course-producer/artifacts/lark-delivery-receipt.json`。
2. 一次只更新一篇；立即回读正文、revision 和评论线程。正文不一致，或任一既有评论/
   回复消失时，停止后续批次并用备份恢复当前文档，不把部分成功报告为整批完成。
3. 全部首轮更新通过后，接收 `course-quality-editor` 的跨课重复终审结果。只重新写入
   命中章节，并再次执行相同的正文与评论回读；未命中章节不重复写。
4. 收据记录每篇的写前/写后 SHA、评论数与 thread id、更新次数和最终状态。正文、评论
   和归属三项全部一致，整批才算完成。

### 保留原稿创建同级文档

解析原文档所属 Wiki/Drive 父级，在同一父节点创建新 Docx。标题明确标出“正式稿”或版本，正文不要重复文档标题。

### 目标文件夹批量建文档

先 `drive +inspect` 取得真实 folder token，再为课纲和每章分别执行 `docs +create --parent-token <folder-token> ... --as user`。本地 `@file` 必须使用当前工作目录下的相对路径。

## 写后双重验证

每次创建或更新后都必须：

1. `docs +fetch --doc '<url-or-token>' --doc-format markdown --as user --format json` 回读正文，核对标题、开头、章节数量和关键文本；
2. 对文件夹交付执行 `drive files list --params '{"folder_token":"<token>","page_size":200}' --as user --format json`，手动翻页并核对新文档的名称与 token。
3. 原位更新还要回读评论及回复，与写前收据按 thread id 对比；只比较数量不够，避免
   “数量相同但原评论被替换”的假通过。

命令返回成功但正文为空、内容不一致或文件夹中找不到对象，均视为未交付。

## 评论协作

只把 `review.jsonl` 中 `needs_decision` 的事项提交给人判断。`auto_fix` 已完成项和普通 `needs_evidence` 留在审校记录，不用把飞书文档变成问题墙。

1. 用 `docs +fetch --doc '<target>' --doc-format xml --detail with-ids --as user` 获取真实 block id。
2. 用问题中的 `locator` 和精确文本定位 block；定位不到时重新读取，不猜 id。
3. 调用 `drive +add-comment --doc '<target>' --block-id '<id>' --content '[...]' --as user` 添加局部评论。
4. 目标 block 不支持评论时，锚定最近的文本子 block；仍不可定位时保留到交付报告，不降级成误导性的随机评论。

## CEO 审查队列

只有当前环境能从已有配置或用户提供位置准确找到审查队列时才更新。记录最终文档链接、审查状态、AI 自检结果和需要判断的具体事项。无法定位、缺 scope 或队列结构变化时，记录 blocker，但不阻塞已验证的文档交付。不得硬编码 app/table/token。

## 安全与完成检查

- 不输出或持久化 app secret、access token、device code 等凭据。
- 不在群聊发起用户 OAuth；权限不足按 bridge 与 `lark-shared` 规则处理。
- 原位覆盖、外部发布和高风险写入遵守确认门禁。
- 所有目标 URL 已解析到真实对象，正文回读通过，文件夹归属验证通过。
- 评论均锚定精确文本 block，数量与待判断事项一致。
- 原位批量更新的正文 SHA、既有评论 thread id、回复和解决状态均与收据一致。
- 审查队列更新成功或明确记录为非阻塞未完成。

把文档 URL、token、回读摘要、归属验证和评论结果写入阶段产物，再登记检查点。