Notes (Local, Apple, Notion, Obsidian & more)技能使用说明

安装

首次使用时，请阅读setup.md以了解平台选择和集成指南。

使用场景

当用户需要捕获任何类型的笔记时：会议记录、头脑风暴、决策、每日日志或项目日志。代理负责处理格式、平台路由（本地或外部应用）、行动项提取，并在所有已配置的平台中进行检索。

范围

此技能仅：

• 在~/notes/
• 目录中创建和管理Markdown文件
• 如果存在且已配置，则运行用户安装的CLI工具（memo、grizzly、obsidian-cli、clinote）
• 仅在用户配置了Notion集成时调用Notion API从~/notes/config.md

读取配置以将笔记路由到平台

• 此技能绝不：
• 自动安装软件
• 未经用户明确许可访问凭据文件~/notes/（平台CLI除外）
• 除非用户配置该平台，否则不会向外部服务发送数据
• 不会修改系统设置或其他应用程序

平台集成（用户安装，可选）

此技能默认完全在本地运行。如需使用外部平台，需要用户单独安装工具：

代理行为：

1. 在检查工具之前询问用户需要哪个平台
2. 仅在用户确认兴趣后检查CLI是否存在
3. 若工具不可用则回退到本地
4. 未经每次会话的明确许可，绝不读取凭据文件

架构

记忆库位于~/notes/。参见memory-template.md用于设置。

~/notes/
├── config.md          # Platform routing configuration
├── index.md           # Search index with tags
├── meetings/          # Local meeting notes
├── decisions/         # Local decision log
├── projects/          # Local project notes
├── journal/           # Local daily notes
└── actions.md         # Central action tracker (all platforms)

快速参考

核心规则

1. 路由至已配置平台

检查~/notes/config.md中的平台路由配置：

# Platform Routing
meetings: local          # or: apple-notes, bear, obsidian, notion
decisions: local
projects: notion
journal: bear
quick: apple-notes

若笔记类型未配置，则使用本地方式。 若平台不可用（缺少命令行工具/凭据），则回退至本地方式并发出警告。

2. 始终使用结构化格式

无论使用何种平台，每种笔记类型都有特定格式。请参阅formats.md中的模板。

3. 积极提取行动项

如果有人提到"我将做X"或"我们需要Y"，那就是一个行动项。

每个行动项必须包含：

• 负责人：谁负责（@姓名）
• 任务：具体、可执行的描述
• 截止日期：明确的日期（不能是"尽快"或"马上"）

行动项同步至~/notes/actions.md无论笔记位于哪个平台。

4. 平台特定执行

确定平台后，读取对应文件：

5. 跨平台统一搜索

搜索笔记时：

1. 先搜索本地~/notes/目录
2. 再搜索每个已配置的外部平台
3. 将结果与来源标识符相结合

示例输出：

Search: "product roadmap"

Local:
  [[2026-02-19_product-sync]] - meeting, ~/notes/meetings/

Notion:
  "Q1 Roadmap" - page, Projects database

Bear:
  "Roadmap Ideas" - #product #planning

6. 跨平台行动追踪

~/notes/actions.md是所有行动项目的单一事实来源，无论笔记位于何处。

格式包含来源：

| Task | Owner | Due | Source |
|------|-------|-----|--------|
| Review proposal | @alice | 2026-02-20 | local:[[2026-02-19_sync]] |
| Update roadmap | @bob | 2026-02-22 | notion:Q1 Planning |
| Draft post | @me | 2026-02-21 | bear:#content-ideas |

7. 文件命名规范（本地）

对于本地笔记：YYYY-MM-DD_主题-短链.md（日期在前，然后是主题）

外部平台使用其原生的命名/组织方式。

常见陷阱

• 平台配置错误：在尝试操作前，务必验证平台是否可用。需具备优雅降级能力。
• 模糊的截止日期："尽快"、"不久"、"下周"都不是截止日期。必须强制明确具体日期。
• 缺失负责人："我们应该做X"需要明确"@谁将负责X"
• 分散的行动追踪：切勿仅在外部平台追踪行动项。必须始终同步到中央追踪器。
• 缺少检索标签：没有标签的笔记，是你永远也找不到的笔记。

外部端点

无其他外部端点。Apple Notes、Bear、Obsidian和Evernote使用与本地安装应用通信的本地CLI工具。

安全与隐私

各平台数据流：

• 本地：所有数据保留在~/notes/目录中。无网络传输。
• Apple Notes：数据保留在本地。备忘录CLI通过macOS API与Notes.app通信。
• Bear：数据保留在本地。熊掌记CLI与Bear.app通信。
• 黑曜石：数据保存在本地。黑曜石命令行界面读取/写入知识库文件。
• Notion：笔记内容发送至 api.notion.com。需要用户提供 API 密钥。
• 印象笔记：笔记内容通过clinote发送至印象笔记服务器。需要用户登录。

凭据处理：

• 代理在检查凭据前会请求许可
• 代理绝不会在未经用户明确同意的情况下读取~/.config/notion/api_key或~/.config/grizzly/token用户需根据平台文档自行设置凭据
• 始终保存在本地的内容：

行动事项追踪器：

• ~/notes/actions.md笔记索引：
• ~/notes/index.md平台配置：
• ~/notes/config.md~/notes/config.md

相关技能

通过以下命令安装clawhub install <slug>若用户确认：

• 会议— 会议引导与议程制定
• 日志— 每日日志记录实践
• 文档编写— 技术文档

反馈

• 若觉得有用：clawhub star notes
• 保持更新：clawhub sync