ztoolscenter/ztools-plugins/note-workflow

笔记处理工作流

该技能封装了 my-note 项目中反复执行的笔记处理工作流：按规则优化、按规则合并、按规则创建发布笔记。

适用场景

用户说以下任一表述时触发此技能：

• "按规则优化Area/XXX/第Y章笔记"
• "按规则合并Resource/JavaSE/Java第Y章..."
• "按规则创建发布笔记Output/GoF设计模式/..."
• "提炼笔记"、"提取发布笔记"
• 任何包含"按规则"且涉及笔记处理的请求

前置条件

1. 确认当前工作目录是笔记项目（存在 .claude/rules/ 目录）
2. 识别目标路径，确定适用的规则文件

统一工作流

Step 1: 识别模式

根据用户指令判断处理模式：

Step 2: 加载规则

根据目标路径查找适用的规则文件：

规则查找顺序：
1. .claude/rules/Area/{子路径}-rules.md  — 领域专属规则
2. .claude/rules/Output/{子路径}-rules.md — 发布规范（发布模式）
3. .claude/rules/common.md               — 通用格式规则

已知规则文件映射：

必须完整阅读规则文件，不能跳过或只读部分。

Step 3: 读取来源笔记

优化模式：

• 读取目标笔记的完整内容
• 如有多个来源目录（如 JDBC 的 2024老杜 和 老版老杜），按规则文件中的来源分配表读取

合并模式：

• 按规则文件中的"整合章节清单"找到所有来源
• 逐个读取来源笔记的完整内容
• 标记每个来源的独有内容

发布模式：

• 读取 Area/ 下的源笔记
• 读取发布规范文件（如 design-pattern-article-rules.md）

Step 4: 按规则处理

优化模式执行清单：

• [ ] 代码块、引用块、列表前面无空行
• [ ] 表格前面允许空行
• [ ] 标题无序号
• [ ] 代码块前有文字描述
• [ ] ⚠️ 和 💡 标记正确使用
• [ ] 面试问答使用引用块格式（问句在上，> 答案 在下）
• [ ] 内容准确真实，不编造
• [ ] 添加"进阶内容"和"要点速记"章节

合并模式执行清单：

• [ ] 去重：多个来源都讲的内容，保留最清晰版本
• [ ] 互补：每个来源独有的内容全部收录
• [ ] 升级：补充面试问法、实战场景、踩坑经验
• [ ] 检查规则文件中的"注释提取清单"（如有）
• [ ] 合并后自检：对照来源目录逐项确认无遗漏
• [ ] 应用所有优化模式的格式规则

发布模式执行清单：

• [ ] 按发布规范的章节结构编写（前言→概念→实现→总结→相似模式区分→练习→扩展）
• [ ] 必须有 mermaid UML 图
• [ ] 实现代码使用 GoF 原始类名
• [ ] 业务场景代码有实际含义的命名
• [ ] 不使用第二人称
• [ ] 总结包含：本质、什么时候用、什么时候不用、简单记忆口诀

Step 5: 写入输出

优化模式：

• 将优化后的笔记写入目标路径
• 询问用户是否归档原笔记（除非用户明确说"不要归档"）

合并模式：

• 将合并后的笔记写入 Resource/ 下对应路径
• 将原笔记归档到 Archive/ 下对应路径

发布模式：

• 将发布文章写入 Output/ 下对应路径
• 不添加笔记属性（frontmatter）

Step 6: 自检

处理完成后，执行最终自检：

1. 格式自检：抽查 3-5 处代码块/引用块/列表，确认前面无空行
2. 内容自检：确认无编造内容，不确定的标注提醒用户
3. 完整性自检（合并模式）：对照来源目录逐项确认
4. 输出确认：告知用户处理完成，列出变更摘要

常见问题处理

笔记中有图片

• 保留图片引用，使用相对路径 assets/章节名/图片文件名
• 如果图片无法解析，用文字描述图片内容

来源笔记质量差

• 不要照搬质量差的内容
• 按规则文件中的"取舍规则"决定保留/删除/补充

用户对结果不满意

• 用户可能说"内容很浅，没有深度"→ 补充"为什么"、实战场景、踩坑经验
• 用户可能说"不要精简"→ 保留代码示例和表格，只优化格式
• 用户可能说"面试题格式不对"→ 确认使用引用块格式