前言¶
会议速记、网页摘录、读书划线往往堆在同一篇文档里，事后很难按主题找回，也更难和知识库里的其他笔记建立关联。常见做法是手写模板或自己在 Obsidian 里搭字段，但每次仍要人工拆句、拟标题、补标签。
下面介绍 SkillHub 上的社区 Skill「卡片笔记整理工具」（@user_fe64cf98/card-note-organizer，当前版本 v1.3.0）。它把 Agent 约束成一套固定产出：从任意原始输入生成「标题 → 标签 → 总结 → 要点 → 洞见 →（可选）图示 → 来源」的卡片，并可导出 Markdown/CSV/JSON，或写入 Reminds、Obsidian vault。
这是什么¶
卡片笔记整理工具是发布者 user_fe64cf98 在 SkillHub 上架的 knowledge-management 类 Skill，来源标注为 community。Skill 本体基于通用 SKILL.md 格式，声明支持 workbuddy、claw 等平台；在 Cursor 等客户端中，只要把 Skill 装到对应 Agent 的 skills 目录即可按文档流程调用。
它解决的核心问题是：输入形态杂、输出结构散。对话文本、本地 .md/.txt、URL（由 Agent 抓取正文）都可以作为输入；多条内容混在一起时，Skill 要求先拆分再逐条成卡。成卡后不会默认落盘，而是先让你确认内容，再选择文件、Reminds 或 Obsidian 等出口。
SkillHub 页面显示该 Skill 需配置 API Key（requires_api_key=true），主要对应 Reminds 闪念同步；纯文件导出在官方文档中标注为无需额外配置。
核心功能¶
结构化卡片要素¶
生成逻辑在 Skill 内按模块规范执行（references/ 下各 *-spec.md）。每张卡片依次填充：
- 标题：简短概括主题（规范要求控制在约 10 个汉字以内）。
- 标签：出处、内容、概念三类混排；概念标签只保留与核心论点强相关的术语。
- 一句话总结：压缩主题与核心观点（规范默认约 60 字以内；用户要求「原话」时须逐字保留指定文本）。
- 核心要点：忠实含义而非照抄排版；两个及以上并列维度时优先表格等形式。
- 洞见：在要点之上提炼原文未直接写出的判断；无价值时可省略整段。
- 关键图示：仅当原文含核心图时保留，并识别 Markdown、Obsidian
![[...]]、HTML<img>等语法。 - 来源：仅在材料能确认出处时写入；不明则整段省略，禁止虚构。
生成与修订前还有「内容阻断检查」（Step 3.5），避免单卡讨论时带出同批其他卡片、洞见与要点重复、来源乱写等问题。
输入方式¶
Skill 约定三类入口：
- 对话中直接粘贴文本；
- 给出文件路径（如
.md、.txt）； - 给出 URL，由 Agent 抓取后再整理。
无法解析时会说明原因并请用户改用更标准的输入形式。
输出与导出¶
卡片生成后，Agent 须先询问是否修改，再选择输出目标：
| 方式 | 说明 |
|---|---|
| 文件 | 写入当前工作目录，默认文件名形如 card-notes-{timestamp}.md |
| Reminds | 将已确认 Markdown 转为 HTML 后写入闪念笔记，需 API 密钥 |
| Obsidian | 写入用户指定的 vault 路径，保留 wiki 链接图片语法 |
批量模式用 --- 分隔多张卡片，末尾可生成标签索引；要求逐张确认后再统一写入目标。
除对话内输出外，可用包内脚本做格式转换：
python3 scripts/export_cards.py input.md -f csv -o output.csv
支持 md（默认）、csv、json；加 --tags-only 仅导出标签索引。脚本需在该 Skill 安装目录下执行，或写全路径。
Reminds 相关操作依赖 scripts/create_fleeting.sh、update_fleeting.sh 等；HTML 含中文与 emoji 时，文档要求通过 UTF-8 临时文件重定向传入，避免管道截断多字节字符。
安装与启用¶
安装 SkillHub CLI¶
若尚未安装 CLI，可按 SkillHub 官方安装说明执行：
command -v skillhub && skillhub --version
未安装时（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别：
skillhub install @user_fe64cf98/card-note-organizer --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 技能页将安装提示词发给 Agent，让其按 SkillHub 安装说明 完成安装。
Reminds 相关配置¶
仅在选择 Reminds 输出时需要密钥。Skill 文档给出的配置方式：
- 环境变量
REMINDS_API_KEY（在 reminds-app.com → 设置 → API 生成）； - 本 Skill 的
scripts/.reminids_key文件； - 用户目录下的
~/.reminids_key文件。
Obsidian 输出只需在对话中提供 vault 路径；文件导出无额外配置。
安装或更新 Skill 后，若 Agent 未加载新 Skill，按你所用客户端说明重启或刷新 skills 目录。
典型用法¶
安装完成后以自然语言驱动即可，Skill 未要求记忆专用 CLI 子命令。官方 Quick Start 中的表述可直接复用：
粘贴文字：
帮我把这段话整理成卡片笔记：[粘贴内容]
从链接：
把这个网页内容整理成卡片：https://...
从文件：
把 /path/to/notes.md 整理成卡片
整理结束后，按 Agent 提示选择修改项或输出渠道（文件 / Reminds / Obsidian）。若需 CSV 或 JSON 归档，在已得到 Markdown 卡片后，于 Skill 目录执行上一节的 export_cards.py 命令。
适用场景与注意¶
更适合：
- 读书、播客、文章摘录需要统一卡片模板，便于检索与打标签；
- 已有 Obsidian vault，希望 Agent 按规范写入而非随意 Markdown；
- 使用 Reminds 收集闪念，且能接受 Markdown→HTML 的严格结构校验。
需要注意：
- SkillHub 元数据标记
requires_api_key=true：无 Reminds 需求时可忽略密钥，但若误选 Reminds 输出会被阻断直至配置完成。 - URL 抓取依赖 Agent 环境与网络；失败时文档建议改为粘贴正文或本地文件。
export_cards.py与 Reminds 脚本以 Skill 包内路径为准；升级 Skill 后注意版本仍为 v1.3.0 时行为以当前SKILL.md为准。- 平台字段声明为 workbuddy、claw；在其他 Agent 上使用前请确认其支持社区
SKILL.md技能格式。
截至 SkillHub 页面与抓取数据，该 Skill 分类为 knowledge-management，下载约 808 次；具体评分与安装数以 SkillHub 实时展示为准。
结尾¶
卡片笔记整理工具把「整理笔记」从随意发挥改成可检查的流水线：结构、标签、洞见与来源都有明文规范，输出可落在文件、Reminds 或 Obsidian。若你要在 Agent 工作流里统一知识卡片形态，可从 SkillHub 技能页查看说明并安装 @user_fe64cf98/card-note-organizer。
官方地址：
- SkillHub 页面：https://www.skillhub.cn/skills/user_fe64cf98/card-note-organizer
- API 坐标页：https://api.skillhub.cn/user_fe64cf98/card-note-organizer
