ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则

- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id，且由用户负责生成
- 修改合并模式逻辑，merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress）
- 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled
- 优化状态转换校验，允许特定状态间合法切换
- 简化任务变更消息，移除详细的新增/更新/移除统计
- 更新文档和示例，明确 id 必须由用户生成和使用
- 修复和补充测试，增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑，统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性

2026-06-13 09:22:33 +08:00

4.6 KiB

Raw Blame History

改写增强工作流

用户提供已有文档链接或 token，需要改写、润色、补充或重排版时，遵循本工作流。

核心方法论 — Code-Act Loop

通过自适应的 Code-Act Loop 驱动文档改写，而非固定模板式的工作流。每次任务都循环执行：

Plan（规划） — 根据用户目标和文档当前状态，评估下一步该做什么
Execute（执行） — 运行相应的 lark-cli docs 命令，或 spawn Agent 子任务并行推进
Observe（观察） — 检查命令输出，验证正确性，核查样式是否达标
Iterate（迭代） — 如需调整，回到 Plan 继续循环

核心原则：精准手术优于全量覆盖

精准手术：只改用户指定的 block，不改其他 block。
全量覆盖：如果用户明确要改整篇，才用 overwrite 命令。
保真约束：改写时原文里的 <cite type="user">（@人）、<cite type="doc">（@文档）、<img>、<source>、<whiteboard>、<sheet>、<bitable>、<synced_reference> 等行内组件和资源块一律原样保留（含所有 token / user-id / doc-id 属性），不许替换成纯文本姓名、链接或占位符。

工作流程

第一波 — 分析 + 画板意图识别（串行）

选择读取范围（节省上下文的关键）：
- 用户只改某一节 / 文档较大 → 先 docs +fetch --api-version v2 --scope outline --max-depth 2 拿目录，再 docs +fetch --api-version v2 --scope section --start-block-id <目标标题id> --detail with-ids 精读该节（section 会自动展开到下一个同级/更高级标题前，不用手动算结束 block id）
- 需要精确跨节区间 → docs +fetch --api-version v2 --scope range --start-block-id xxx --end-block-id yyy（或 --end-block-id -1 读到末尾）
- 用户只给了模糊关键词 → docs +fetch --api-version v2 --scope keyword --keyword xxx --context-before 1 --context-after 1 --detail with-ids
- 用户明确要改整篇 → docs +fetch --api-version v2 --detail with-ids
- 详见 lark-doc-fetch.md "意图引导：选择正确的 --scope"
系统性评估：结构清晰度、富 block 密度（≥40%）、元素多样性（≥3种）、连续 <p> 是否超过 3 段、是否有开头 callout 和章节 <hr/>
画板意图识别：逐章节扫描，按 lark-doc-style.md「画板意图识别」表判断哪些段落的信息适合用图表达。重要信息优先画板化，记录需要插图的章节（block ID）、推荐画板类型、mermaid/SVG路径和源内容片段
向用户简要说明改进计划（包含识别出的画板机会）

第二波 — 定向改写（并行 Agent）

优先处理第一波识别出的画板候选段落：参考 lark-doc-whiteboard.md中的方式，插入图表画板。
Spawn 内容改写 Agent 在不重叠的章节上并行改进，各 Agent 收到文档 token 和特定 block ID：（见 lark-doc-style.md）
- 开头适当添加 <callout>、重组引言
- 纯文本转为 <grid>/<table>/<callout>
- 添加低重要度对比分栏、关键提示等富 block；画板类需求只走第 5 步

第三波 — 验证（串行）

获取更新后文档局部内容，重新检查样式指标
未达标则定向修正，向用户呈现结果

Agent 子任务要求

内容改写 Agent 必须收到：文档 token、章节范围（标题/block ID）、lark-doc-xml.md 和 lark-doc-style.md 路径、具体的 docs +update command 和 --block-id。

Mermaid 图由主 Agent 直接插入 <whiteboard type="mermaid">...</whiteboard>，无需 SubAgent。

SVG SubAgent 必须收到：文档 token、插入位置（标题/block ID）、图表目标、源内容片段、lark-doc-xml.md 路径，以及lark-doc-whiteboard.md 中的 "SVG 设计 Workflow" 指南。它只负责插入一个 <whiteboard type="svg">...</whiteboard>，不改其他正文，也不读取 lark-whiteboard。

已有画板更新 SubAgent 必须收到：board_token、图表目标、推荐画板类型、源内容片段、../../../lark-whiteboard/SKILL.md 路径。它只负责写入画板，不改文档正文。

上下文节省提示：Agent 如需在自己负责的章节内重新读取内容，优先用 docs +fetch --api-version v2 --scope section --start-block-id <章节标题id>（自动覆盖整节），或 --scope range --start-block-id xxx --end-block-id yyy 精确区间，只拉自己的章节，不要重复拉全文。

4.6 KiB Raw Blame History Unescape Escape