适用场景

用户发送语音消息。代理平台负责语音转文字（通过其配置的 STT 服务）。本技能将生成的文字转录内容组织为结构化笔记，关联相关内容，并维护一个可扩展的、基于标签的管理系统。

重要提示：语音转文字由平台完成

本技能不执行语音转文字。它依赖代理平台完成以下步骤：

1. 接收用户的音频输入
2. 使用平台所配置的 STT（本地或云端）进行转录
3. 将生成的文字转录内容传递给本技能，供其组织处理

本技能仅在 ~/voice-notes/ 中本地组织并存储文字转录内容。它从不访问或保存任何音频文件。

架构设计

所有数据均存储于 ~/voice-notes/ 目录下。初始化设置请参阅 memory-template.md。

~/voice-notes/
+-- memory.md           # HOT：标签注册表 + 最近活动
+-- index.md            # 笔记索引（含标签与链接）
+-- transcripts/        # 原始转录文本（纯文本）
+-- notes/              # 已处理笔记
+-- archive/            # 已弃用内容

快速参考

数据存储

所有数据均存储于 ~/voice-notes/ 目录下。首次使用时需手动创建目录结构：

mkdir -p ~/voice-notes/{transcripts,notes,archive}

作用范围

本技能仅执行以下操作：

• 接收来自代理平台的文字转录内容
• 将转录内容与笔记保存至 ~/voice-notes/
• 基于内容语义关联相关笔记
• 管理用户自定义的标签

本技能绝不会执行以下任何操作：

• 执行音频转文字（属平台职责）
• 访问音频文件
• 未经用户明确确认即删除内容
• 访问 ~/voice-notes/ 以外的任何文件
• 向外发送任何数据
• 要求提供 API 密钥或认证凭据

自我修改限制

本技能绝不会修改自身的 SKILL.md 文件。所有数据均仅存于 ~/voice-notes/ 下的各文件中。

核心规则

1. 永不丢失信息

2. 标签体系优先于文件夹结构

• 标签定义位于 ~/voice-notes/memory.md 的 ## Tag Registry 区域
• 用户决定标签粒度（宽泛或细致）
• 优先复用已有标签，避免重复新建
• 每篇笔记可拥有多个标签

3. 自动识别相关内容

在创建新笔记前：

1. 搜索现有笔记中是否存在主题重叠
2. 若存在关联 → 追加内容或建立链接（而非重复创建）
3. 若为延续性内容 → 扩展已有笔记
4. 若存在观点冲突 → 建立演进式链接，同时保留双方内容

4. 文档规模化处理

当单篇笔记长度超过约 100 行时：

1. 识别其中自然形成的内容模块
2. 拆分为若干子笔记，并建立相互链接
3. 父级笔记转为概览页，仅包含各子笔记的链接
4. 类似 Notion：笔记中可嵌套其他笔记

5. 渐进式加载（Progressive Disclosure）

6. 重构混乱输入

用户可能以意识流方式口述：

• 提炼清晰语义
• 按逻辑结构化组织
• 保留表达细微差别（避免过度压缩）
• 归类关联要点

7. 首次会话初始化

首次使用时向用户询问：

• “您倾向使用宽泛分类还是细致标签？”
• “是否有现成主题可用于初始化？”

常见陷阱

• 本应追加内容却新建笔记 → 务必先执行搜索
• 标签命名不一致 → 创建新标签前务必查阅注册表
• 过度压缩导致语义失真 → 始终忠实还原用户意图与细微表达
• 误删“过时”内容 → 应归档（archive），永不直接删除