初始化设置

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

适用场景

用户需要记录任意类型的笔记：会议纪要、头脑风暴、决策记录、日常日志或项目日志。Agent 负责格式化、平台路由（本地或外部应用）、待办事项提取，并支持在所有已配置平台间进行内容检索。

能力范围

本技能 **仅执行以下操作**：

• 在 ~/notes/ 目录下创建和管理 Markdown 文件
• 若用户已安装并配置了 CLI 工具（memo、grizzly、obsidian-cli、clinote），则调用这些工具
• 仅当用户已完成 Notion 集成配置时，才调用 Notion API
• 从 ~/notes/config.md 读取配置，以决定笔记应路由至哪个平台

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

• 自动安装软件
• 未经用户明确授权访问凭证文件
• 读取 ~/notes/ 目录以外的文件（平台专用 CLI 工具除外）
• 向外部服务发送数据，除非用户已主动配置对应平台
• 修改系统设置或其他应用程序

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

本技能默认 100% 本地运行。如需接入外部平台，用户需单独安装对应工具：

Agent 行为规范：

1. 在检查工具是否存在前，先询问用户希望启用哪些平台
2. 仅在用户确认有意使用某平台后，才检查对应 CLI 是否存在
3. 若所需工具不可用，则自动回退至 Local 模式
4. 每次会话中，未经用户显式授权，绝不读取任何凭证文件

架构设计

记忆数据存于 ~/notes/。初始化设置请参阅 memory-template.md。

~/notes/
├── config.md          # 平台路由配置
├── index.md           # 带标签的搜索索引
├── meetings/          # 本地会议笔记
├── decisions/         # 本地决策日志
├── projects/          # 本地项目笔记
├── journal/           # 本地日常笔记
└── actions.md         # 全平台统一待办事项追踪器

快速参考

核心规则

1. 按配置平台路由

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

# 平台路由
meetings: local          # 或：apple-notes、bear、obsidian、notion
decisions: local
projects: notion
journal: bear
quick: apple-notes

若未配置某类笔记的目标平台，则默认使用 local。
若目标平台不可用（缺少 CLI 或凭证），则回退至 local 并发出警告。

2. 始终采用结构化格式

无论目标平台为何，每种笔记类型均有其专属格式。模板详见 formats.md。

3. 积极提取待办事项

若出现 “I’ll do X” 或 “we need to Y” 等表述，即视为待办事项。

每个待办事项 **必须包含**：

• 负责人：明确责任人（@name）
• 任务描述：具体、可执行的动作
• 截止时间：明确日期（禁止使用 “soon”、“ASAP” 等模糊表述）

所有待办事项均同步至 ~/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_topic-slug.md（日期优先，其次为主题）

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

常见陷阱

• 平台配置错误：始终在尝试前验证平台是否可用；失败时应优雅降级。
• 截止时间模糊：“ASAP”、“soon”、“next week” 等非有效截止时间；必须强制指定明确日期。
• 责任人缺失：“We should do X” 必须明确为 “@who will do X”。
• 待办事项分散追踪：切勿仅在外部平台中维护待办事项；必须同步至中心追踪器。
• 缺失检索标签：无标签的笔记等于无法被检索到的笔记。

外部端点

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

安全与隐私

各平台数据流向：

• Local：全部数据保留在 ~/notes/，不经过网络。
• Apple Notes：数据保留在本地。memo CLI 通过 macOS API 与 Notes.app 通信。
• Bear：数据保留在本地。grizzly CLI 与 Bear.app 通信。
• Obsidian：数据保留在本地。obsidian-cli 读写 Vault 文件。
• Notion：笔记内容发送至 api.notion.com；需用户提供 API key。
• Evernote：笔记内容经 clinote 发送至 Evernote 服务器；需用户完成登录。

凭证处理规范：

• Agent 在检查凭证前，必须向用户请求权限
• Agent 绝不会在未经用户显式授权的情况下读取 ~/.config/notion/api_key 或 ~/.config/grizzly/token
• 用户需根据各平台官方文档自行完成凭证配置

始终保留在本地的内容：

• 待办事项追踪器：~/notes/actions.md
• 笔记索引：~/notes/index.md
• 平台配置：~/notes/config.md

相关技能

如用户确认安装，可使用命令：clawhub install

• meetings — 会议主持与议程管理
• journal — 日常日志实践
• documentation — 技术文档编写

反馈

• 若本技能有用：clawhub star notes
• 保持更新：clawhub sync