dy9759/review-notes

Review Notes（审查代码笔记，子 skill）

本 skill 为 coding-assistant 的子 skill，负责技术笔记的创建与编辑并写入 WPS 笔记保存；编码规范、单测、编译/lint 由主 skill 负责。

何时触发

自动启动（以下任一即启动读取与写入 WPS 笔记、生成技术文档）：

• 编码工具 + 关键词：用户使用 Cursor、Codex、Claude Code、AS code 等编码工具进行编写、审查或优化代码时，且用户提到「架构」「设计图」「核心方法」「关键技术」时，自动读取当前文件/工程上下文并写入 WPS 笔记，生成或更新技术文档。
• 用语：审阅代码、技术文档、总结关键代码、记录关键技术点、记入笔记、生成技术文档、把这段记入笔记、记一下这个实现、整理成笔记。
• 场景：使用上述编码工具编写或审查代码且涉及核心技术点（如 Android、iOS、JNI/Rust、文档/资源/网络等）；代码或注释中出现「核心代码」「关键实现」「技术要点」「生成技术文档」。
• 优化完成后：用户优化代码或优化类完成后，若该类或该段代码的注释中出现「技术文档」「总结」「笔记」等相关字样，则自动启动并写入笔记；执行时仍按先查后编、标题与类/目录强相关、等待用户指令直接辅助等既有规则。

执行流程

1. 确认范围：根据用户当前选中的代码、当前打开的文件或当前目录，确定要写入笔记的技术点与核心代码段；确定当前类名或「目录/类名」用于匹配已有笔记。
2. 先查后编：先 list_notes 查看是否已有与当前类/目录相关的笔记（标题包含类名或目录/类名子串即视为匹配）。若已存在：read_note + get_note_outline 获取 note_id 与最新 block 列表，不新建，直接在该笔记上编辑。仅当不存在匹配笔记时才 create_note 新建；创建后将该 note_id 视为本会话「当前笔记」。
3. 完整笔记结构：笔记必须包含 7 个二级标题：核心技术（配图）、核心代码、关键技术点、核心类和职责、调用链（mermaid，可配图）、架构概览（配图）、注意事项。其中架构、核心技术、调用链的图示：优先使用 generate_image（WPS 笔记）根据描述生成图片，再用 insert_image 插入；不可用时用 mermaid 或官网/掘金/维基 insert_image。见 reference §0.2、§2.1。
4. 笔记标题：新建时标题简洁、专业，与当前类或目录强相关（类名或「目录/类名」）。见 reference/reference.md。
5. 调用链：笔记中的「调用链」须用 mermaid 格式（flowchart 或 sequenceDiagram），见 reference。
6. 核心代码：可从以下方式获取并写入笔记——注释内关键字（注释中出现「核心代码」「关键实现」「技术要点」等时，读取对应行/块或函数体）、用户复制的代码块（用户复制后告知）、剪切板中的代码块（用户告知剪切板已粘贴代码）、本文件选中代码、用户指定的某一个函数（取完整函数体）。写入时优先用 edit_block(op="insert") / edit_block(op="replace") 以代码块形式写入该笔记。
7. 写入/更新 WPS 笔记：在已确定的笔记上执行 edit_block / batch_edit、核心代码区、insert_image、find_tags 等；笔记须写入 WPS 笔记并保存。
8. 用户新增标题：当用户在笔记中新增二级标题或其他小标题时，根据用户诉求在该标题下补充相应内容（edit_block(op="insert")）。
9. 等待用户指令并直接辅助：确定当前笔记后，等待用户后续意图（插入图片、插入核心代码、修改标题、全局替换等），直接在该笔记上完成，无需用户再单独发「对某笔记做某操作」的指令。用户说「这篇」「当前笔记」「就这个」时沿用已确定的 note_id。
10. 主动更新：在用户未关闭当前笔记期间，约 1 分钟后或适当时机主动刷新并更新该笔记（如根据当前文件/工程变化补充内容、更新调用链等），直至用户主动关闭当前笔记。见 reference §0.4。
11. 全局替换：用户修改笔记中某处标题、人名或关键术语时，直接在该笔记内全局替换（search_note_content / read_note 定位，再用 edit_block(op="replace") / batch_edit 替换）。
12. 整理格式：创建或编辑后自动整理笔记格式；见 reference。

能力调用

• get_current_note：用户可能在 WPS 中已打开某笔记；在未指明「对哪篇笔记」时优先用其返回的 note_id 作为当前笔记。见 reference §7。
• list_notes / read_note / get_note_outline / search_note_content：查看、定位与搜索笔记内容；匹配时标题包含类名/目录子串即可。
• create_note / edit_block / batch_edit：创建与编辑；同一笔记多处改动优先 batch_edit 一次完成。
• sync_note：每次对笔记编辑后调用，便于 WPS 端即时看到并保存。
• generate_image（WPS 笔记）：根据调用链/架构/核心技术描述生成示意图；生成后使用 insert_image 将图片插入笔记对应段落。见 reference §2.1。
• insert_image / find_tags：配图与标签。

与 WPS 协作要点：编辑前用 get_note_outline 取最新 block_id，避免 BLOCK_NOT_FOUND；若发生该错误则重新 get_note_outline 后重试。完成一次写笔记后可简短提示「可说「加图」「助手核心代码」或「改标题」继续编辑」。详见 reference §7。

与主 skill 的分工

| 场景 | coding-assistant（主） | review-notes（本子 skill） | |----------------|------------------------|-----------------------------| | 编码、单测、编译/lint | 负责 | 不负责 | | 阅读/审查代码时记笔记 | 引用本子 skill 与 reference | 专门负责笔记创建与编辑 |