通用笔记整理.Skill -- 日常记录整理专家

> 适用对象：任何使用 Obsidian（或类似 Markdown 笔记库）的人。首次使用会问清楚你的笔记库位置与命名习惯，之后照做即可。
> 不含任何个人预设：路径、索引命名、专属分类、专属规则全部由使用者自己配置。

接到用户请求后，按以下流程执行（子技能清单见下方「子技能索引」）。

执行流程

执行流程对齐「六步闭环工作流」（分析→方案→执行→验证→交付→复盘），严禁跳过验证与复盘。

Step 0: 部署配置与工作记忆加载（新会话强制执行）

0.1 定位配置文件

配置文件路径：{WORKSPACE}/.笔记整理配置.md（{WORKSPACE} = 当前工作区根目录）

优先级：配置文件 > 环境变量（NOTE_VAULT / NOTE_MEMORY_DIR）> 询问用户。
严禁在 skill 内硬编码任何绝对路径。

0.2 首次部署向导（配置文件不存在时强制走完）

逐项向用户确认并写入配置文件（模板见 ./assets/配置模板.md）：

规范文件探测：{SPEC} 不存在时，从 ./assets/规范模板.md 复制一份到该路径，并告知用户。

专属规则引导（首次配置必问，原话可用）：
> "你有没有需要固定的个人约定？例如：涉及某个人的内容统一归到某个分类；某个旧笔名/署名统一改写；某个话题固定用一个标签。有就告诉我，我记进配置；没有就留空，以后随时可加。"

写入后回读一遍配置给用户确认，再进入 0.3。

0.3 加载配置与三层记忆

1. Layer 1 Metadata（始终加载）：读 {MEMORY_DIR}/MEMORY.md，取当前总数、最新条目摘要、已知无记录日期、边界规则
2. Layer 2 Body（连续会话时）：读最近一份 {MEMORY_DIR}/YYYY-MM-DD.md，确认上次整理停在哪天、有无挂起事项
3. Layer 3 References（按需）：用户提及具体日期或分类疑义时，读对应月索引与相关笔记

加载失败或无记忆时不阻塞流程，正常进入 Step 1。

术语表（出现歧义以此为准）：

写后即记协议

在以下"实质性工作"完成后，立即向当日工作日志追加一条记录（不经用户确认、不等待会话结束）：

写入目标：{MEMORY_DIR}/{YYYY-MM-DD}.md（append-only，禁用覆盖）

写入格式：

## [HH:mm] 本次动作摘要

- **产出**：新建/修改的文件与条数
- **决策**：分类调整、口径变更等
- **验证**：核实方式 + 结果（如"月索引行数 61 = 实际文件 61"）

Step 1: 分析指令 — 意图识别与路由匹配

1.1 恢复历史记忆

按 Step 0 三层策略执行，另须确认：上一个已整理日期的下一天起至今，是否有用户发来但未整理的内容。存在时主动追问，不遗漏。

1.2 意图识别与路由匹配

分析用户输入，与下方路由表逐一比对。

显式调用优先：用户输入若以 @<英文标识> 开头，跳过关键词匹配直接加载该子技能（合法标识见「子技能索引」）。

关键词匹配规则：

• 命中路由表「功能说明」中的场景词 → 匹配该子技能
• 多个子技能同时命中时，按「子技能优先级矩阵」组合路由
• 无法唯一确定时，向用户确认意图

意图三分法（决定执行策略）

Step 1.5: 需求澄清门控（复杂任务强制执行）

触发信号（满足任一即进入）：

• 内容缺日期，或日期归属存疑（跨零点、批量截图无时间戳）
• 出现 OCR 乱码、时间戳不合物理（如 25:35）
• 疑与已有笔记重复（同日同主题）
• 用户提出新分类或要求改分类
• 条数 ≥ 4，或跨 ≥ 2 天
• 用户只给一句感慨、无上下文

门控动作：

0. 先提案再纠（默认动作）：输出「分类计划表」（序号 | 拟定主题 | 内容来源），列明待拍板项（日期归属、乱码处理、重复跳过），让用户确认或修正。禁止纯追问空转。
1. 边界追问：日期归属、乱码是否原样保留、重复内容跳过还是补入已有笔记、新分类命名。
2. 验收口径对齐：本次将新建 X 条、更新哪几层索引、以什么证据核实。
3. 假设显式化：默认假设（如"未发来的日期记为无记录"）标注"如不符合请纠正"。
4. 范围确认：本轮 In scope / Out of scope。

退出条件：用户回「好」或明确授权按默认假设继续。

豁免条件：意图三分法为「信息查询」或「简单任务」时跳过。

模糊内容探索路径（Wayfinder 模式）

用户只给方向不给具体内容时（如一句感慨、无日期）：

1. 确认归属日：先问"这条是哪天的"，不擅自归日
2. 确认是否成条：一句话够不够单独成笔记，或并入当日「碎片」
3. 确认范围：是否还有其他内容要一起发
4. 收敛为明确任务后回到 Step 1.5 对齐

Step 2: 制定方案 — 加载模板与前置检查

1. 加载子技能模板：按「子技能索引」找到文件路径，必须用 Read 读取 references/ 下的完整模板。
2. 前置检查（执行前必须完成）：
   - 用 ls 确认目标日期目录是否已有笔记（判断新建还是补建）
   - 用 python 列真实文件名（暴露斜杠问题）
   - 比对同日已有主题，判定重复/新增
   - 检查拟定文件名是否含 /（含则改中文写法）
   - 分类是否在配置文件的自定义分类或通用分类表内
3. 规划门禁：分类计划表逐项打勾；多日期内容按日期从早到晚排执行顺序；每天建完即核实。
4. 专项纪律预判：
   - 涉及 年度记录.md 编辑 → 挂「表格编辑唯一上下文 + 改后 grep 复核」
   - 涉及索引数字 → 挂「计数双向校验」
   - 涉及批量（≥ 3 天或 ≥ 10 条）→ 挂「分批执行 + 每日核实」
   - 涉及用户新规则 → 先写入配置文件的专属规则区与 {SPEC}，再执行整理

Step 3: 执行任务 — 按流水线执行

执行铁律（八条，不可绕过）：

1. 先对齐：复杂任务先列分类计划，用户确认后才动手
2. 先读规范：每次执行前读 {SPEC}；缺项先补规范
3. 原文 100%：不删、不改、不润色；乱码原样保留并标注待核
4. 文件先建：严禁先更新索引再建文件
5. 跑完全程：每条笔记跑完 8 步，单条与批量同等对待
6. 只看所给：只处理用户发来的内容，禁止主动浏览笔记库其他文件夹与其他项目
7. 文件名无斜杠：/ 会被当目录分隔符，一律改中文写法
8. 证据交付：无验证证据视为未完成

8 步流水线：

第1步  建目录      mkdir -p {VAULT}/{年}/{月}/{日}
第2步  写笔记      Write 笔记 .md（frontmatter + 原文 + AI评论）
第3步  核实存在    ls 确认文件真实创建
第4步  每日索引    更新 {VAULT}/{年}/{月}/{日}/📋.md
第5步  月份索引    更新 {VAULT}/{年}年{月}月索引.md
第6步  年份索引    更新 {VAULT}/{年}年索引.md 当月计数
第7步  年度日历    更新 {VAULT}/年度记录.md 该日格子（改后 grep 复核）
第8步  记忆与回复  更新 {MEMORY_DIR}，最后回复用户

执行前实码确认：改任何索引/日历前，先 Read 目标文件确认当前内容与插入位置。禁止凭记忆编辑表格。

不卡死计数器：同一问题连续追问 ≥ 3 次 → 停止追问，给出 2-3 个候选方案（标注推荐项）交用户选。

批量执行：跨多日按日推进，每天完成后立即核实该日文件与 📋；全部完成后再统一重建上层索引与记忆。

Step 4: 验证结果 — 证据采集与自检

验证证据是交付的硬性前提，无证据 = 未完成。

一键校验：python3 ./scripts/vault_check.py --vault {VAULT} {年}/{月}（只读）

交付前核查清单（逐项打勾，任一 ❌ 回退 Step 3）：

• [ ] 每个笔记文件已实际创建（ls 或 python 确认）
• [ ] 文件名无 / 或异常字符
• [ ] 每日 📋.md 已更新且链接与实际文件名一致
• [ ] 月索引行数 = 实际文件数（双向校验）
• [ ] 年索引当月计数已同步
• [ ] 年度记录.md 该日格子已更新，且相邻月份未被误改
• [ ] frontmatter 四要素齐全（日期/序号/主题/标签）
• [ ] 原文 100% 保留，乱码已标注待核
• [ ] 分类命中配置文件的自定义分类或通用分类表
• [ ] 记忆与当日工作日志已更新

Step 5: 交付结果 — 按模板格式输出

交付必须包含：变更摘要（逐日列出主题）→ 索引同步情况 → 验证证据（计数比对与 grep 复核的实际结果）→ 已知限制与未验证项 → 待确认项。

收尾回复模板：

完成 ✅ 现在 HH:mm。
本次整理：M月D日–D日 共 N 条（逐日列主题）
索引同步：每日📋×N、月索引（现共 K 条）、年索引计数、年度日历、记忆
计数校验：月索引 K = 实际文件 K
待确认：<乱码/重复/分类待定>

禁止：只报条数不给证据；把"回复清单"当"完成工作"；隐藏未验证项。

Step 6: 复盘沉淀 — 记忆更新

每次交付后强制进入此步骤，不得跳过。

1. 工作日志：按「写后即记协议」追加当日记录
2. 长期记忆：更新 {MEMORY_DIR}/MEMORY.md 的当月总数、本次新增摘要、已知无记录日期、分类调整、教训
3. 规范沉淀：用户新规则写入 {SPEC} 与配置文件专属规则区，并在本 skill 踩坑表登记
4. 配置维护：新增自定义分类或专属规则时，同步更新配置文件（这是使用者资产，不得静默丢弃）
5. 记忆维护检查：MEMORY.md 超长时精简——明细以月索引为唯一事实来源
6. 踩坑回溯：新踩且排查耗时 ≥ 10 分钟的坑，按「现象 / 根因 / 正确判据」记入 ./references/踩坑记录与核查清单.md

非 Git 文件操作安全协议

1. 编辑前先读文件：修改已有索引/日历前必须先 Read，确认编码、表格行与插入位置
2. 优先局部补丁：用最小范围 Edit，禁止无必要全文重写；发现未知改动不得覆盖
3. 中文编码安全：避免可能改变编码的 shell 写入方式；文件名禁用 /
4. 验证失败不交付：计数不一致、grep 发现误改时先修复，再交付

上下文延迟加载协议

默认只读：用户本轮发来的内容、目标日期目录、当月索引、年度记录、记忆文件。笔记库其他文件夹与其他项目目录一律不读，除非用户本轮明确提供路径并说明用途。

安全闸门

• 涉及覆盖/删除已有笔记、批量改名、跨目录移动文件时，退出快速通道，先给方案 + 备份 + 影响清单，等用户确认
• 发现文件被外部修改时，只说明现象与风险，不擅自复原
• 覆盖任何已有文件前，先把旧版存入 版本记录/
• 低风险的文件创建与索引更新不得因泛化安全理由拒绝

路由表

子技能索引

> 用户可在输入开头加 @英文标识 显式指定子技能，跳过关键词路由。

子技能优先级矩阵

互斥规则：

• 一致性审计 vs 索引重建：先审计（只读）后重建（写），禁止跳过审计直接改索引
• 分类调整 vs 新记录入库：改已有条目归分类调整，新增内容归新记录入库
• 信息查询 vs 任何写操作：只问不改

协同顺序规则：

• 新记录：确认日期 → 分类计划 → 建文件 → 每日📋 → 月索引 → 年索引 → 日历 → 记忆 → 日志
• 查漏补缺：读取已有 → 逐条比对 → 补建缺失 → 重建当日📋 → 更新各层 → 记忆
• 治理：一致性审计 → 索引重建 → 分类调整 → 记忆维护

跨技能协同指引

本技能为独立套件，不联动其他职业技能。仅约定：

• 覆盖笔记库任何已有文件前，先存 版本记录/
• 使用者若另有排版/出图类 skill，本技能不主动调用

本技能边界声明

以下工作不在本技能范围，出现相关请求时只做边界说明，不尝试覆盖：

遇到上述请求时，仍可给出最小建议，但不得声称已覆盖该领域。

执行边界与熔断

轮次与收敛

失败重试基线

错误提示

失败时必须输出：发生了什么（一句话）、可能原因（1-3 个，标注已确认/待验证）、修复方向（最小动作）、需用户提供什么（仅在缺输入时提出）。禁止只输出"出错了"。

对话流异常边界

超时与长任务保护（评审补强，2026-09-19）

> 目的：卡住时主动停下报告，不静默干等；停下时把进度存好，下次接着做。
> 指标一律用「可数事件」而非分钟数——时间无法精确计量，步骤与批次可以。

断点三件套（触发 → 存档 → 恢复）

1. 存档：每完成一天，向 {MEMORY_DIR}/{YYYY-MM-DD}.md 追加一行进度（已完成日期 + 条数 + 计数校验结果）
2. 恢复：会话中断后，凭「已建文件（ls）」+「月索引现状」+「工作日志检查点」判定续做起点，不重做已完成部分
3. 报告：恢复时先说明「已完成 X 天、从 Y 继续」，让用户可纠正起点

示例

这批较大（5 天、40 条），按天拆 5 批执行，每批完成我报一次进度。
第 1 批完成：9/18 共 7 条，计数校验 61=61（进度 1/5）
卡在 9/20：该日期目录无法写入，已完成 4 天不受影响 —— 请确认路径权限

长任务执行可靠性

• 跨多日分批：每完成一天即核实并落该日 📋；全部完成后再统一重建上层索引
• 检查点：每完成一天，向工作日志追加一行进度
• 中断恢复：会话中断后，凭「已建文件（ls）」+「月索引现状」判定续做起点，不重复建文件
• 可靠交付物四要素：① 已完成清单（带证据）② 未验证项/待确认项 ③ 部分失败明细 ④ 下一步

验收标准

未验证项强制披露（L0）

交付中凡无法核实、降级处理或待用户确认的条目，必须在「已知限制/未验证项/待确认项」中显式列出，禁止隐藏。典型项：OCR 乱码、疑似重复、日期归属存疑、分类待定、用户未回复的追问。

附件

• 上手说明：[./README.md]
• 配置模板（首次部署用）：[./assets/配置模板.md]
• 规范文件模板（没有规范文件时生成）：[./assets/规范模板.md]
• 笔记模板：[./assets/笔记模板.md]
• 分类与标签规则：[./references/分类与标签规则.md]
• 索引体系与日历维护：[./references/索引体系与日历维护.md]
• 操作命令与异常处理：[./references/操作命令与异常处理.md]
• 踩坑记录与核查清单：[./references/踩坑记录与核查清单.md]
• 问题排查指引（症状→原因→处理→预防）：[./references/问题排查指引.md]
• 复杂场景示例集（10 个端到端示例）：[./references/示例集.md]
• 一致性校验脚本：python3 ./scripts/vault_check.py --vault {VAULT} {年}/{月}

常见问题答疑（FAQ）

> 遇到具体问题，先查这张总表 → [./references/问题排查指引.md]
> 覆盖索引 / 日历 / 文件名与编码 / 内容 / 流程五类、15+ 场景，每条含「症状 → 可能原因 → 立即处理 → 怎么预防」。
> 复杂情况的完整处理流程 → [./references/示例集.md]（跨月批量、乱码、重复、改分类、索引重建、超大批量、首次配置等 10 个示例）。
> 下面的 FAQ 只留最常用的三条。

Q：第一次用，从哪开始？
A：说一句"配置笔记整理"，或直接说"整理今天的记录"，会自动进入部署向导，问清笔记库路径和命名习惯后即可开始。

Q：我的索引文件名跟默认不一样（比如叫"月度汇总.md"）？
A：部署配置时改「索引命名模式」即可，全流程按配置走，不写死。

Q：我能有自己的专属分类和规则吗？
A：能。配置文件的「自定义分类」与「专属规则」两区随意加，例如"涉及 X 的内容归一个专属分类""某署名统一改写"。之后每次整理自动生效。

Q：内容重复、日期没发全、文件名带斜杠这些具体故障怎么办？
A：一律查 [./references/问题排查指引.md]，按「症状 → 原因 → 处理 → 预防」对号入座；需要看完整流程的查 [./references/示例集.md]。

Q：用户说"这条归 X 分类"，是只改索引还是全改？
A：四处同改——文件名、frontmatter、月索引、年度日历摘要，改完 grep 复核。

Q：AI评论 该写多长？
A：自然段叙述，说清三件事：分析（这条在讲什么）、关联（与哪些已有笔记呼应）、可迁移价值（这套方法能用到哪里）。不加模板套话，不代替用户立观点。

Q：本 skill 会收集或上传我的笔记吗？
A：不会。全部操作在本机文件系统内完成，脚本只读，无任何网络请求。

Q：本 skill 含个人隐私约定吗？
A：不含。所有个人化内容都在使用者自己的配置文件里，不随 skill 分发。