目录
-
- 前言
- 本文效果
- 一、封装成Claude Code命令
-
- 命令作用域
- 方式1：项目命令（仅当前项目有效）
- 方式2：全局命令（所有项目有效）
- 验证命令
- 二、在Claude Code中推送笔记
-
- 方法1：使用命令
- 方法2：直接对话推送
- 实际使用场景
- 三、Commands vs Skills：该用哪个？
-
- 先说结论
- 什么是Skills？
- 两者对比
- 实际测试
- 将命令转为Skills
- 隐私保护
- 技能下载
- 写在最后
前言
在上一篇文章——将Markdown文件推送到浮墨笔记 中，实现了将Markdown文件推送到浮墨笔记的基础功能。本文将介绍进阶玩法：
让AI成为你的笔记助手！
本文效果
用法举例：
/flomo 今天的讨论很有价值，记录一下：xxx
# Claude Code执行后…
推送成功!
在Claude Code中应用： 
推送结果展示：
一、封装成Claude Code命令
Claude Code命令（Command）是一种可复用的指令模板，存储在 .claude/commands 目录下。通过斜杠命令（如 /flomo）即可调用，无需重复输入完整指令。
命令作用域
Claude Code命令有两个作用域：
| 项目命令 | 项目根目录/.claude/commands/ | 仅在当前项目中可用 |
| 全局命令 | ~/.claude/commands/ | 所有项目中都可用 |
Windows系统中，~ 代表用户目录，如 C:\\Users\\你的用户名\\
方式1：项目命令（仅当前项目有效）
步骤1：创建目录
在项目根目录下创建 .claude/commands 目录：
mkdir –p .claude/commands
步骤2：创建命令文件
在 .claude/commands 目录下创建 flomo.md 文件 并复制粘贴以下内容：
—
description: 将内容推送到浮墨笔记
allowed-tools: Bash
—
将以下内容推送到浮墨笔记：
python "D:/workspace/01-Projects/xxx/flomo_push.py" "D:/workspace/01-Projects/xxx/.claude/tmp.md" (记得替换路径)
请先将用户提供的内容写入临时文件 `.claude/tmp.md`，然后再执行上述命令推送。推送完成后告知用户结果，并删除临时文件。
注意要替换其中的路径！！！ 脚本路径最好使用绝对路径，因为不同项目的当前目录不同。 命令中的 flomo_push.py 来自上一篇文章：将Markdown文件推送到浮墨笔记
方式2：全局命令（所有项目有效）
如果你希望在任何项目中都能使用 /flomo 命令，需要将命令文件放在全局目录。
创建命令文件
在 C:\\Users\\你的用户名\\.claude\\commands\\ 目录下创建 flomo.md 文件，内容：
—
description: 将内容推送到浮墨笔记
allowed-tools: Bash
—
将以下内容推送到浮墨笔记：
python "~/.claude/tools/flomo_push.py" "~/.claude/tools/tmp.md"
请先将用户提供的内容写入临时文件"~/.claude/tools/tmp.md"，然后再执行上述命令推送。推送完成后告知用户结果，并删除临时文件。
主要针对Windows系统描述，其它系统大致差不多。 如果没有 commands 文件夹，手动创建一个。 命令中的 flomo_push.py 来自上一篇文章：将Markdown文件推送到浮墨笔记，脚本可以放入 tools 文件夹中（不存在则自己创建）。
命令文件关键点：
- description: 命令的简短描述
- allowed-tools: 声明需要使用的工具（Bash）
- 指令内容：告诉Claude如何处理用户输入并调用脚本
验证命令
保存文件后，重新启动Claude Code，输入 / 即可看到命令列表中出现 flomo。
- 带user后缀的是全局命令，只要当前操作系统用户登录后，在任意路径中打开Claude Code都能调用这个命令。
- 带project后缀是项目命令，只针对特定路径生效（包括子目录）。
二、在Claude Code中推送笔记
方法1：使用命令
直接在Claude Code对话中输入：
/flomo 今天学习了Claude Code的命令封装，非常实用！
Claude会自动：
方法2：直接对话推送
你也可以直接告诉Claude：
帮我把下面这段话推送到浮墨笔记：今天在学习Python时，理解了requests库的使用方法…
实际使用场景
场景1：记录学习笔记
/flomo #Python 学习了requests库发送POST请求的方法：
– headers设置Content-Type
– json参数传递数据
– response.raise_for_status()检查错误
场景2：记录讨论要点
/flomo #项目讨论 今天和AI讨论了API设计：
1. 采用RESTful风格
2. 认证使用JWT Token
3. 错误码统一定义
场景3：记录灵感想法
/flomo #灵感 如果能做一个浏览器插件，一键把网页内容推送到浮墨，应该很实用
三、Commands vs Skills：该用哪个？
在使用Claude Code时，你可能会注意到除了commands，还有skills（技能）。这两者有什么区别？
先说结论
经过测试发现，两者都能手动和自动触发，说明官方已经将 commands 和 skills 整合了，可能只有优先级的区别了。鼓励优先制作为 skills，它可以发布，也可以被其它工具使用。
什么是Skills？
Skills 存储在 .claude/skills/ 目录下，结构比commands复杂，是一个文件夹：
~/.claude/skills/
└── claude-api/
├── SKILL.md # 技能定义
├── LICENSE.txt # 许可证
├── python/ # 多语言支持
├── typescript/
└── …
两者对比
| 存储位置 | .claude/commands/ | .claude/skills/ |
| 文件形式 | 单个 .md 文件 | 文件夹（含 SKILL.md） |
| 手动触发 | 支持 | 支持 |
| 自动触发 | 支持，但优先级较低 | 支持，优先级更高 |
| 复杂度 | 简单，适合单一任务 | 复杂，适合多场景任务 |
| 适用场景 | 固定流程、简单操作 | 需要智能判断、多分支处理 |
实际测试
我测试了自动触发（不加命令前缀）。 
自动触发成功，说明 Claude Code 会自动识别意图并匹配对应的命令或者技能。
将命令转为Skills
如果你觉得commands够用，可以直接用。但如果想要更好的自动触发体验，或者以后想发布分享给其他人用，可以升级成skills。
提示词：
将flomo命令（user）转化为 skills，使用 /skill-creator 技能；将其中用到的 python 脚本整合到一起；最后删除旧的flomo命令和脚本。
设置好API后，重启终端，输入Claude -c 进入，测试技能推送效果。提示词如下：
测试skills，将本次操作写一个简短的摘要（纯文本，标签为#测试），推送到笔记中
手机APP上收到：
隐私保护
提示词：
优化flomo脚本，为保证隐私，将FLomo_URL从环境变量中获取，不要明文保存在脚本中。
设置好API后，重启终端，输入 claude -c 进入，测试技能推送效果。 提示词如下：
测试skills，将本次操作写一个简短的摘要（纯文本，标签为#测试），推送到笔记中
手机APP上收到：
技能下载
下载链接：学习、创作技能分享之flomo
写在最后
这个小工具用起来确实方便，以前想记点东西还得切到浮墨APP，现在在终端里敲 一行命令 或者 一句简单的提示词 就搞定了。
几个踩坑的地方提醒一下：
- 路径别写错，特别是全局命令
- 浮墨的API key自己保管好，别传到GitHub上去了。建议将API地址存入环境变量，不要明文写在脚本中
- 项目命令和全局命令选哪个？看你需求，我一般常用的工具放全局，特定项目的东西放项目目录
- Commands和Skills选哪个？简单场景用commands，想要更好的自动触发体验或者以后想分享给别人，就用skills
如果你也经常用浮墨记东西，可以试试这个玩法。
