@dev-workflow/skill 0.1.0

package/tools/lark/README.md

@@ -0,0 +1,78 @@
+# tools/lark
+
+飞书能力共享工具。为 devFlow 及后续 skill（如 consistency-checker 读飞书 PRD）提供飞书 Open API 封装。
+
+## 目录
+
+```
+tools/lark/
+├── README.md
+├── scripts/
+│   ├── lark_api.mjs                # 核心 Open API 封装（token / request）
+│   ├── lark_api.test.mjs
+│   ├── lark_read_docx.mjs          # 读 Wiki / Docx，支持章节抽取和缓存
+│   ├── lark_publish_doc.mjs        # 发布 Markdown 到 Wiki 子文档
+│   ├── lark_check_permissions.mjs  # 检查目标文档 / 父节点访问权限
+│   └── markdown_to_lark_blocks.mjs # Markdown → Docx blocks JSON
+└── references/
+    ├── prepare.md                  # 环境变量配置说明
+    ├── lark-read.md                # 读飞书文档规则
+    └── lark-doc.md                 # 写飞书文档规则
+```
+
+## 部署路径约定
+
+skill / tool 打包部署时保持仓库路径：`.agent/tools/lark/scripts/`。
+
+## 输入输出
+
+### `lark_read_docx.mjs`
+```
+node .agent/tools/lark/scripts/lark_read_docx.mjs --url <飞书链接> [--section <标题>] [--level <层级>]
+```
+输出：文档全文或指定章节内容。
+
+### `lark_publish_doc.mjs`
+```
+node .agent/tools/lark/scripts/lark_publish_doc.mjs --title <标题> --file <path>
+node .agent/tools/lark/scripts/lark_publish_doc.mjs --title <标题> < document.md
+```
+输出：新建文档链接、node token、doc token、写入 block 数。
+
+### `lark_check_permissions.mjs`
+```
+node .agent/tools/lark/scripts/lark_check_permissions.mjs [--url <飞书链接>]
+```
+输出：canRead / canWrite / 错误信息。
+
+### `markdown_to_lark_blocks.mjs`
+```
+node .agent/tools/lark/scripts/markdown_to_lark_blocks.mjs --file <path>
+```
+输出：飞书 Docx blocks JSON。
+
+## 环境变量
+
+- `FEISHU_APP_ID` — 飞书应用 ID
+- `FEISHU_APP_SECRET` — 飞书应用密钥
+- `FEISHU_WIKI_PARENT_NODE_TOKEN` — Wiki 父节点 token（发布必需）
+
+详见 [references/prepare.md](./references/prepare.md)。
+
+## 自检
+
+```
+node --test tools/lark/scripts/lark_api.test.mjs
+```
+
+## 消费者
+
+- `skills/execution/devFlow/` — `prepare` / `lark-read` / `lark-doc` 子命令
+- `skills/review/consistency-checker/`（规划中）— 读飞书 PRD
+- 未来其他需要飞书读写的 skill
+
+## 安全约束
+
+- 所有密钥只从环境变量读，不写死
+- 脚本 stdout 不输出密钥
+- 错误信息不泄露内部路径

package/tools/lark/references/lark-doc.md

@@ -0,0 +1,156 @@
+# lark-doc 子命令
+
+`lark-doc`
+用于把技术文档落地到飞书 Wiki 父节点下。它负责发布流程，不负责生成页面技术方案正文；正文生成应由
+`page-tech` 等子命令完成。
+
+## 定位
+
+- 输入：Markdown 文档、已生成的技术方案正文，或用户要求先生成再发布的文档内容。
+- 输出：飞书 Wiki 子文档链接。
+- 默认目标：环境变量 `FEISHU_WIKI_PARENT_NODE_TOKEN` 指向的 Wiki 父节点。
+
+## 环境变量
+
+必须从环境变量读取配置：
+
+```text
+FEISHU_APP_ID
+FEISHU_APP_SECRET
+FEISHU_WIKI_PARENT_NODE_TOKEN
+```
+
+规则：
+
+- 不要把 app secret 写入 Skill、仓库文件、技术方案正文或日志。
+- 不要在最终回复中回显 secret。
+- 如果任一变量缺失，停止发布并告诉用户缺少哪个变量。
+- 飞书发布默认走 Open API（应用身份），不需要初始化 `lark-cli`；设 `FEISHU_BACKEND=larkcli` 可改用 lark-cli 用户身份，`auto` 自动择优。仅 larkcli 模式需先 `lark-cli auth login`；该模式下发布到 Wiki 需用户具备 Wiki 节点创建 scope，缺失时按 `prepare` 回退 openapi。
+
+## 发布流程
+
+优先使用脚本，不要现场重写发布逻辑。
+
+```bash
+node .agent/tools/lark/scripts/lark_publish_doc.mjs \
+  --title "客户管理页面开发技术方案" \
+  --file /path/to/document.md
+```
+
+也可以通过 stdin 传入 Markdown：
+
+```bash
+node .agent/tools/lark/scripts/lark_publish_doc.mjs --title "标题" < document.md
+```
+
+脚本固定处理：
+
+1. 获取 `tenant_access_token`。
+2. 使用 `FEISHU_WIKI_PARENT_NODE_TOKEN` 获取 Wiki 父节点信息。
+3. 在 Wiki 父节点下创建新的 Docx 子文档。
+4. 将 Markdown 转换为飞书 Docx blocks。
+5. 按 40 个 blocks 一批写入，规避飞书单次 `children` 最大 50 的限制。
+6. 写入后读取文档前部 blocks 校验。
+7. 输出标题、链接、node token、doc token、写入 block 数。
+
+发布前需要单独检查父节点权限时运行：
+
+```bash
+node .agent/tools/lark/scripts/lark_check_permissions.mjs
+```
+
+## Wiki 节点规则
+
+- 用户提供的 `/wiki/{token}`
+  链接中的 token 应视为 Wiki 节点 token，不要当作普通云盘 `folder_token`。
+- 默认父节点 token 来自 `FEISHU_WIKI_PARENT_NODE_TOKEN`。
+- 如果用户提供了新的 Wiki 链接，本次发布优先使用用户提供的 token。
+- 如果应用身份没有权限访问父节点，不要绕过；提示用户需要给应用授权该 Wiki 节点，或改用用户身份授权。
+
+## 文档标题规则
+
+标题优先级：
+
+1. 用户明确给出的标题。
+2. 技术方案中的一级标题。
+3. 根据页面名称生成，例如 `{页面名称} 页面开发技术方案`。
+4. 如果仍无法确定，向用户确认标题。
+
+标题要求：
+
+- 简短、可搜索。
+- 不包含密钥、token 或临时调试信息。
+
+## Markdown 转 Docx blocks 规则
+
+`scripts/markdown_to_lark_blocks.mjs` 必须支持：
+
+- 一级到三级标题。
+- 普通段落。
+- 无序列表。
+- 有序列表。
+- 表格。
+- 代码块。
+- 引用 Mermaid 源码的代码块。
+
+处理规则：
+
+- Mermaid 代码块必须保留源码，便于后续修改。
+- 页面结构和组件拆分图推荐使用 `flowchart LR`，发布时保留 Mermaid 源码。
+- `mindmap` 只作为纯概念层级图的可选语法，不作为页面技术方案默认图。
+- 如果文档包含由 `design-lark-chart`
+  生成的飞书画板链接，应在对应位置插入链接说明。
+- 暂不支持的复杂 Markdown 语法不要丢弃，保留为普通文本或代码块，并在发布结果中说明。
+- Markdown 表格可先降级为普通文本，除非用户明确要求飞书原生表格。
+
+## 排版与飞书呈现规范（定稿模板）
+
+这是经过真实评审打磨的定稿格式，所有经 `lark-doc` 发布的技术方案默认按此排版；各领域子命令（`api-tech`、`page-tech` 等）可在此基础上追加自己的硬规则。对应的 Markdown→飞书块语法由
+`markdown_to_lark_blocks` + `lark_publish_doc` 支持：
+
+- **引用块**：实体说明、接口「统一约定」等用 `> 文本` → 飞书引用块（左侧竖线），增强层次。
+- **高亮块 callout**：`> [!WARNING] …`（⚠️）/ `> [!TIP] …`（💡）/ `> [!NOTE] …`（📝）→ 飞书高亮块。
+  只在 mock / 风险 / 重要提示处用，不滥用。
+- **粗体 label**：`**用途**`、`**入参**`、`**出参**`、`**说明**`、`**错误码**` 等标签用 `**…**` 加粗。具体 label 集合由各领域子命令的呈现规则定义。
+- **分隔线**：接口 / 大条目之间用 `---` → 飞书分割线，增加留白。
+- **表格**：发布时自动设 `header_row`（灰底表头）+ 按内容自适应满宽列宽，单元格只含内容（行高紧凑）。
+- **状态流转 / 流程**：用 ` ```mermaid ` 代码块（源码）。`lark-doc` 不渲染 Mermaid 成图，需要真图请走 `design-lark-chart` 生成飞书画板后在文档中引用（见「图表规则」）。
+
+## 图表规则
+
+- `lark-doc` 不负责渲染 Mermaid。
+- 需要图形化落地到飞书时，先使用 `design-lark-chart` 生成图形产物，再由
+  `lark-doc` 在文档中引用。
+- 如果只有 Mermaid 源码，可以直接写入代码块。
+- 如果 `design-lark-chart` 或飞书画板链路提示需要
+  `lark-cli`，再按该 Skill 的要求初始化；不要为了普通文档读写提前初始化。
+
+## 权限失败处理
+
+常见失败原因：
+
+- 应用没有 Wiki 父节点访问权限。
+- 应用缺少云文档或 Wiki 相关 API 权限。
+- 父节点 token 不是 Wiki 节点 token。
+- 使用了应用身份，但目标空间只允许用户身份写入。
+- 单次写入 children 超过 50。发布脚本已按 40 分批，手工调用时必须遵守。
+
+处理规则：
+
+- 明确说明失败原因和下一步处理建议。
+- 不要改用其他未知目录。
+- 不要创建到默认根目录。
+
+## 标题与编号规则
+
+- 分节使用原生 Markdown 标题层级（`#`/`##`/`###`），最多三级，对应飞书
+  heading1/2/3。
+- 不在标题文本中手写序号（写 `## 接口设计`，不写 `## 2. 接口设计`）；序号交给飞书文档的「标题自动编号」显示能力。
+- 若发布后未显示蓝色序号，提示用户在飞书文档设置中开启「标题自动编号」，不通过手写序号绕过。
+
+## 安全规则
+
+- 不打印 `FEISHU_APP_SECRET`。
+- 不把 access token 写入文件。
+- 不把飞书 API 响应中的敏感字段完整贴入最终回复。
+- 最终只返回文档链接、标题和必要的发布状态。

package/tools/lark/references/lark-read.md

@@ -0,0 +1,235 @@
+# lark-read 子命令
+
+`lark-read`
+用于读取飞书云文档、Wiki 文档或文档链接，并将内容转换为后续研发工作流可用的上下文。它只负责读取和整理上下文，不负责生成最终技术方案，也不负责发布文档。
+
+## 定位
+
+- 输入：飞书文档链接、Wiki 链接、Docx 链接或用户指定的飞书文档 token。
+- 输出：结构化上下文摘要。
+- 用途：供 `page-tech`、后续技术方案子命令或人工审核使用。
+
+## 环境变量
+
+必须从环境变量读取配置：
+
+```text
+FEISHU_APP_ID
+FEISHU_APP_SECRET
+```
+
+规则：
+
+- 不要把 app secret 写入 Skill、仓库文件、技术方案正文或日志。
+- 不要在最终回复中回显 secret。
+- 如果任一变量缺失，停止读取并告诉用户缺少哪个变量。
+- 飞书读取默认走 Open API（应用身份），不需要初始化 `lark-cli`；设 `FEISHU_BACKEND=larkcli` 可改用 lark-cli 用户身份，`auto` 自动择优。仅 larkcli 模式需先 `lark-cli auth login`，配置见 `prepare`。
+
+## 链接类型识别
+
+根据 URL 路径判断类型：
+
+| 链接形态                | 识别结果             | 处理方式                                   |
+| ----------------------- | -------------------- | ------------------------------------------ |
+| `/wiki/{token}`         | Wiki 节点 token      | 先获取 Wiki 节点信息，再取得真实文档 token |
+| `/docx/{token}`         | 新版 Docx 文档 token | 直接读取 Docx 文档                         |
+| `/docs/{token}`         | 旧版 Docs 文档 token | 走旧版文档读取能力，或提示需要转换         |
+| `/drive/folder/{token}` | 云盘文件夹 token     | 不直接作为文档读取，需要用户指定具体文档   |
+| 其他飞书链接            | 未知类型             | 不猜测，要求用户提供可读文档链接           |
+
+规则：
+
+- `/wiki/{token}` 不是普通文件夹 token。
+- 不要把 Wiki token 当作 Docx token 直接读取。
+- 如果链接类型不明确，必须向用户确认。
+
+## 读取流程
+
+优先使用脚本，不要现场重写飞书读取逻辑。
+
+```bash
+node .agent/tools/lark/scripts/lark_read_docx.mjs \
+  --url "https://example.feishu.cn/wiki/xxxx" \
+  --section "客户管理" \
+  --level 3
+```
+
+同一个文档需要读取多个章节时，必须一次性使用
+`--sections`，不要对同一个飞书文档并发执行多个读取命令：
+
+```bash
+node .agent/tools/lark/scripts/lark_read_docx.mjs \
+  --url "https://example.feishu.cn/wiki/xxxx" \
+  --sections "客户管理,新增客户（create-client）,客户列表查询（client-list）"
+```
+
+脚本固定处理：
+
+- 获取 `tenant_access_token`。
+- 识别 Wiki / Docx 链接。
+- Wiki 节点自动解析真实 Docx token。
+- 分页读取 Docx blocks。
+- 解析飞书数字枚举 block type。
+- 输出标题、block 数、标题目录和可选章节 Markdown。
+- 支持 `--sections` 一次抽取多个章节，避免重复拉取同一篇文档。
+- 支持 5 分钟本地临时缓存；同一轮写作中重复读取相同文档会复用缓存。需要强制刷新时传
+  `--no-cache`。
+- 如果 `--level`
+  未命中，会自动按标题文本在所有层级中查找；唯一命中时直接返回，多个命中时返回候选项。
+- 遇到飞书频控会在脚本内部重试；调用方不要手动并发读取同一文档或反复 sleep 重跑。
+
+需要预检查权限时，先运行：
+
+```bash
+node .agent/tools/lark/scripts/lark_check_permissions.mjs --url "飞书链接"
+```
+
+只有脚本不满足任务时，才临时补充读取逻辑，并把可复用能力沉淀回脚本。
+
+## 输出格式
+
+读取后输出：
+
+- 文档标题
+- 文档链接
+- 文档类型
+- 主要章节
+- 原始内容摘要
+- 结构化信息
+- 待确认项
+
+## 给下游子命令的上下文格式
+
+读取结果按下游子命令选择输出结构。触发场景默认对应关系：`page-tech` /
+`page-build` / `contract-check` 用「前端上下文」；`api-tech` 用「后端上下文」。
+如果同一文档同时供前后端使用，分别输出两份，不合并成一份。
+
+### 前端上下文（page-tech 等前端子命令）
+
+```md
+## 飞书文档上下文
+
+### 文档信息
+
+- 标题：
+- 链接：
+- 类型：
+
+### 页面基础信息
+
+- 页面名称：
+- 所属模块：
+- 页面类型：
+
+### 页面目标
+
+### 页面范围
+
+- 页面入口：
+- 页面结构：
+- 页面状态：
+- 非目标范围：
+
+### 功能需求
+
+### 字段清单
+
+### 接口信息
+
+### 交互规则
+
+### 权限要求
+
+### 非功能要求
+
+### 待确认项
+```
+
+### 后端上下文（api-tech 子命令）
+
+```md
+## 飞书文档上下文
+
+### 文档信息
+
+- 标题：
+- 链接：
+- 类型：
+
+### 服务 / 模块目标
+
+### 接口需求
+
+### 字段 / 数据结构
+
+### 业务流程
+
+### 错误与边界
+
+### 待确认项
+```
+
+规则：
+
+- 没有在文档中出现的信息不要补全。
+- 可以做结构化归纳，但不能改变原文含义。
+- 如果原文存在冲突，保留冲突并写入待确认项。
+- 如果同一文档要抽取 PRD 多个页面或接口多个小节，先用 `--sections`
+  一次读取；只有不同飞书文档之间才可以并行读取。
+
+## Markdown 转换规则
+
+脚本读取飞书 blocks 后，优先转换为 Markdown 风格文本：
+
+- 标题保留层级。
+- 段落保留原文。
+- 列表保留顺序。
+- 表格尽量转成 Markdown 表格。
+- 代码块保留语言标识。
+- 图片、附件、链接保留名称和 URL。
+- 无法解析的 block 类型保留为占位说明。
+
+### 行内样式对齐
+
+飞书 `text_run.text_element_style` 与 Markdown 语义按下表对齐，嵌套顺序固定为
+`link > strikethrough > bold > italic > inline_code`（从外到内）。`inline_code`
+必须在最内层：Markdown 反引号内的内容不会被解析，若把 `~~x~~` 反过来包裹会渲染成字面横线而非删除线。
+
+| 飞书样式                        | Markdown 输出           | 备注                              |
+| ------------------------------- | ----------------------- | --------------------------------- |
+| `bold`                          | `**text**`              |                                   |
+| `italic`                        | `*text*`                |                                   |
+| `strikethrough`                 | `~~text~~`              | 文档中间的横线 = 删除语义         |
+| `inline_code`                   | `` `text` ``            |                                   |
+| `link.url`                      | `[text](url)`           | URL 尝试 `decodeURIComponent` |
+| `underline`                     | 忽略                    | Markdown 无原生语法               |
+| `text_color` / `background_color` | 忽略                    | 同上                              |
+
+区分：
+
+- 章节匹配（`--section` / `--sections`）用纯文本比较，不会因标题带样式而失配。
+- 输出到下游子命令的 markdown 保留上述行内样式。
+
+## 失败处理
+
+常见失败原因：
+
+- 应用没有文档查看权限。
+- 应用没有 Wiki 节点访问权限。
+- 应用缺少 `docx:document:readonly`。
+- 链接不是文档链接。
+- Wiki 节点下不是 Docx 文档。
+- 文档使用了当前读取逻辑不支持的旧格式。
+
+处理规则：
+
+- 明确说明失败原因和下一步建议。
+- 不要根据链接标题或 URL 猜测文档内容。
+- 不要继续生成依赖该文档内容的技术方案。
+
+## 安全规则
+
+- 不打印 `FEISHU_APP_SECRET`。
+- 不把 access token 写入文件。
+- 不把飞书 API 响应中的敏感字段完整贴入最终回复。
+- 最终只输出文档内容摘要、结构化上下文和必要的读取状态。

package/tools/lark/references/prepare.md

@@ -0,0 +1,147 @@
+# prepare 子命令
+
+`prepare`
+用于说明 `devFlow` 使用飞书读写能力前需要配置的环境变量和权限准备。它只负责给用户清晰的准备清单，不负责读取或发布飞书文档。
+
+## 定位
+
+- 输入：用户要求初始化、准备环境，或询问飞书配置。
+- 输出：环境变量清单、变量用途、配置建议和后续检查方式。
+- 目标：让用户在使用 `lark-read`、`lark-doc` 前知道必须准备什么。
+
+## 后端选择（FEISHU_BACKEND）
+
+飞书读写有两个后端，用环境变量 `FEISHU_BACKEND` 选择，下面的变量需求按后端区分：
+
+- 缺省 / `openapi`：应用身份 + 飞书 Open API（现状）。需要 `FEISHU_APP_ID` /
+  `FEISHU_APP_SECRET`，且目标文档 / Wiki 节点要逐一授权给应用。
+- `larkcli`：通过 `lark-cli` 以**用户身份**调用同样的 Open API，免去逐篇授权。不使用
+  `FEISHU_APP_ID/SECRET`，改由 `lark-cli auth login` 登录授权。可选 `FEISHU_LARKCLI_AS`（默认
+  `user`）切换 user / bot 身份，`FEISHU_LARKCLI_BIN` 覆盖 lark-cli 路径。
+- `auto`：`lark-cli` 已登录则用 larkcli，否则回退 openapi；两者都不可用时报清晰错误。
+
+## openapi 模式必需环境变量
+
+openapi（或 auto 回退到 openapi）时必须配置：
+
+```text
+FEISHU_APP_ID
+FEISHU_APP_SECRET
+```
+
+用途：
+
+- `FEISHU_APP_ID`：飞书自建应用的 app id。
+- `FEISHU_APP_SECRET`：飞书自建应用的 app secret，用于换取 tenant access token。
+
+规则：
+
+- 不要把 `FEISHU_APP_SECRET` 写入 Skill、仓库文件、技术方案正文或日志。
+- 不要在最终回复中回显 `FEISHU_APP_SECRET`。
+- openapi 模式缺少任一变量时，`lark-read` 和 `lark-doc` 都不能继续执行。
+- openapi 模式直接使用飞书 Open API，不需要初始化 `lark-cli`；larkcli 模式不需要 app secret。
+
+## larkcli 模式准备
+
+设 `FEISHU_BACKEND=larkcli`（或 `auto` 且已登录）时：
+
+1. 安装 `lark-cli`（`@larksuite/cli`），确保它在 `PATH` 中（或用 `FEISHU_LARKCLI_BIN` 指定）。
+2. 运行 `lark-cli auth login` 完成用户身份授权，`lark-cli auth status` 确认对应身份为 `ready`。
+3. 用户需具备所需 scope：读取需要 docx / wiki 读取相关 scope；**发布到 Wiki 还需要 Wiki 节点创建
+   scope**。若发布因缺 scope 失败，lark-cli 会返回清晰错误；此时重新 `lark-cli auth login` 扩展
+   scope，或本次改用 openapi 应用身份发布。
+4. larkcli 模式不需要 `FEISHU_APP_ID/SECRET`；`FEISHU_WIKI_PARENT_NODE_TOKEN` 仍是发布所需的目标参数。
+
+## 发布 Wiki 文档所需变量
+
+发布到飞书 Wiki 父节点时，还必须配置：
+
+```text
+FEISHU_WIKI_PARENT_NODE_TOKEN
+```
+
+用途：
+
+- `FEISHU_WIKI_PARENT_NODE_TOKEN`：默认发布目标的 Wiki 父节点 token。
+
+规则：
+
+- 只读取飞书文档时不需要该变量。
+- 使用 `lark-doc` 发布文档时需要该变量，除非用户本次明确提供其他 Wiki 父节点链接。
+- `/wiki/{token}` 中的 token 是 Wiki 节点 token，不是云盘文件夹 token。
+- 如果应用身份没有父节点权限，不要改用未知目录；提示用户给应用授权该 Wiki 节点。
+
+## 建议配置方式
+
+建议把变量配置在本机 shell 环境、CI secret 或 Codex 运行环境中，不要提交到仓库。
+
+本机全局配置优先写入：
+
+```text
+/Users/wenjin/.zshenv
+```
+
+`.zshenv` 会在 zsh 启动时读取，适合给本机终端、Codex 运行环境和 Node 脚本提供全局环境变量。
+
+示例：
+
+```bash
+# /Users/wenjin/.zshenv
+export FEISHU_APP_ID="cli_xxx"
+export FEISHU_APP_SECRET="***"
+export FEISHU_WIKI_PARENT_NODE_TOKEN="xxx"
+```
+
+如果只读取飞书文档：
+
+```bash
+# /Users/wenjin/.zshenv
+export FEISHU_APP_ID="cli_xxx"
+export FEISHU_APP_SECRET="***"
+```
+
+修改后，新启动的 zsh 会自动读取；当前终端如需立即生效，可以执行：
+
+```bash
+source /Users/wenjin/.zshenv
+```
+
+## 权限准备
+
+飞书自建应用需要具备对应权限，并且目标文档或 Wiki 节点需要授权给该应用。
+
+读取文档通常需要：
+
+- 文档查看权限。
+- Docx 文档读取相关 API 权限。
+- 如果读取 Wiki 链接，还需要 Wiki 节点访问权限。
+
+发布文档通常需要：
+
+- Wiki 父节点访问权限。
+- 创建 Wiki 子文档权限。
+- Docx 文档写入相关 API 权限。
+
+## 可选检查
+
+检查目标文档或 Wiki 父节点权限时，优先使用脚本：
+
+```bash
+node .agent/tools/lark/scripts/lark_check_permissions.mjs --url "飞书链接"
+```
+
+检查默认 Wiki 父节点权限时：
+
+```bash
+node .agent/tools/lark/scripts/lark_check_permissions.mjs
+```
+
+## 输出要求
+
+执行 `prepare` 时，回复用户：
+
+1. 读取和发布分别需要哪些变量。
+2. 哪些变量是必需，哪些只在发布 Wiki 时需要。
+3. 如何配置变量，不要求写入仓库。
+4. 普通飞书文档读写不需要初始化 `lark-cli`。
+5. 如果后续要读文档或发布文档，应先确认应用权限和文档授权。