前言¶
会议、访谈、口述想法往往先落在录音里，事后整理成可检索的笔记还要再听一遍、手打一遍。若你已经在用 Claude、ChatGPT、Gemini 或 Cursor 等 Agent 做知识管理，更自然的路径是让 Agent 按统一 Skill 规范完成「转写 + 结构化」，而不是每次手写一长段提示词。下面介绍 SkillHub 上的社区 Skill「录音转笔记」（@user_4200edd7/record2note），它面向 macOS 与 Windows，把语音自动转成结构化 Markdown 笔记。
这是什么¶
「录音转笔记」是 SkillHub 分类 knowledge-management 下的社区 Skill，坐标 @user_4200edd7/record2note，当前版本 1.0.0，发布者为 user_4200edd7（SkillHub 页面标注作者为 Moonight）。官方简介说明：将语音录音自动转录为结构化 Markdown 笔记，适用于各类 AI Agent。Skill 标签标明 requires_api_key=false，即按页面信息不强制要求单独配置 API Key。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_4200edd7/record2note
- 资源地址：https://api.skillhub.cn/user_4200edd7/record2note
核心功能¶
依据官方简介与 SkillHub 页面，可核实的能力如下。
- 语音转 Markdown：把录音转写并整理为结构化 Markdown 笔记，便于纳入现有文档或知识库流程。
- 两种处理模式：支持自动监控与手动处理。自动监控适合持续落盘录音后由 Skill 跟进；手动处理适合指定文件或单次任务。
- 跨平台：兼容 macOS 与 Windows。
- Agent 通用：说明中写明适用于 Claude、ChatGPT、Gemini 等 AI Agent；在 Cursor 等支持 Skills 目录的客户端中，可按 SkillHub 通用安装方式启用。
页面未公开更细的转写引擎、目录监听路径或输出模板字段时，不宜自行假设；具体行为以安装后的 SKILL.md 及 Agent 会话中的 Skill 指引为准。
安装与启用¶
SkillHub 推荐通过官方安装说明与 CLI 安装技能包，并必须把文件装到当前 Agent 能识别的 skills 目录。
1. 检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装「录音转笔记」到当前 Agent 的 skills 目录¶
安装命令需带 --dir，指向当前环境的 skills 路径；未指定时默认落在 ./skills/，多数 Agent 不会自动加载。
skillhub install @user_4200edd7/record2note --dir <skills 目录>
常用客户端 skills 目录（摘自 SkillHub 安装文档，按你实际使用的客户端择一）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
SkillHub 页面还提供另一种方式：将安装提示发给 AI，让其根据 https://skillhub.cn/install/skillhub.md 安装 @user_4200edd7/record2note。内容与上述 CLI 路径一致，适合已习惯用对话驱动安装的读者。
安装后按所用 Agent 的要求重启或刷新 Skills 列表，使 record2note 被加载。
典型用法¶
公开资料未给出逐步截图或固定 CLI 子命令，可复现的流程可以收敛为下面几步。
- 完成上一节的安装，确认 Agent 已加载
@user_4200edd7/record2note。 - 准备待处理的语音录音（格式与路径以 Skill 内说明为准）。
- 按需求选择模式：
- 手动处理：在对话中说明要转写的录音文件或任务，让 Agent 按 Skill 规则输出结构化 Markdown。
- 自动监控：在 Skill 允许的前提下配置监控来源，新录音落入后由 Skill 流程自动转写为笔记。
输出目标为结构化 Markdown，便于后续用 Git、Obsidian、静态站或其它 Markdown 工具继续编辑。
适用场景与注意¶
适合谁
- 需要把会议、采访、口述内容沉淀为 Markdown 笔记的开发者或写作者。
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望统一「录音 → 笔记」流程的团队或个人。
使用注意
- 本 Skill 为 community 来源，版本 1.0.0；升级或行为变更请以 SkillHub 页面与
skillhub更新结果为准。 - 自动监控涉及本机路径与权限，在 Windows 与 macOS 上部署前建议在测试目录验证，避免误扫无关文件。
- 转写质量、语种支持、文件大小上限等细节未在抓取页面中逐项列出，遇到限制应以 Skill 文档或 Agent 报错信息为准。
- SkillHub 统计（页面与元数据可能不同步）：资料中可见评分 100000、下载约 3993 次，仅作商店热度参考，不代表转写效果承诺。
结尾¶
「录音转笔记」把语音录音和结构化 Markdown 笔记串成一条 Agent Skill 链路，并区分自动监控与手动处理，覆盖 macOS 与 Windows。若你正在用 SkillHub 管理知识类 Skill，可从展示页查看说明，并按安装文档将 @user_4200edd7/record2note 装入当前客户端的 skills 目录。
- https://www.skillhub.cn/skills/user_4200edd7/record2note
- https://api.skillhub.cn/user_4200edd7/record2note
