我让 Coding Agent 帮我管 Notion 任务，学到了什么

Wed, 30 Sep 2026 00:00:00 +0000

问题

我的任务都放在 Notion 里。那算是我的第二个大脑——任务、项目、时间追踪，全都串在一起。可通过图形界面去折腾它……挺费劲。我得先打开 Notion，点来点去，找到对的数据库，再点开卡片改。往往正跟 Coding Agent 写代码写到一半，忽然想到该建一个后续任务，这一来一回的上下文切换代价极大。

我想要的其实很简单：用人话跟Agent说，它替我把 Notion 里的任务管好。「加个任务：修登录那个 bug，明天截止。」「今天我手上都有什么？」「给 auth refactor 开个计时。」说完就完事，不用碰界面。

架构

方案就是 notion-todo——一个给 Coding Agent 用的 skill，分三层：

Notion 是唯一的数据源头来源，也是给人看的界面，卡片本来就住在里面。
本地一个 SQLite 镜像存一份又快又能查的副本。代理读的是这个，不是 API。
一个 CLI 脚本（notion_cards.py）包掉所有写入操作——创建、修改、删除、时间追踪、评论。每写一次，镜像自动跟着同步。

┌─────────────────────────────────────────────────────────────┐
│  User (natural language)                                     │
└─────────────────────────────┬───────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  Agent (LLM) — interprets intent, picks the right action    │
│  guided by SKILL.md (prompt)                                │
└─────────────────────────────┬───────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  CLI Script (deterministic) — notion_cards.py               │
│  handles CRUD, time tracking, comments, sync                │
└──────────┬──────────────────────────┬───────────────────────┘
           │                          │
           ▼                          ▼
┌──────────────────────┐    ┌──────────────────────────┐
│  Notion (source of   │◄──►│  SQLite Mirror (fast     │
│  truth, human UI)    │    │  reads, agent queries)   │
└──────────────────────┘    └──────────────────────────┘

第一个坎：我压根没写脚本

一开始我一个脚本都没写。只是把 Notion 数据库长什么样讲给代理听，告诉它「Notion API 是这样用的，你去建一张卡」。于是每一次它都得自己去搞 HTTP 请求、拼 JSON payload、处理 relation，还得顾上镜像同步——全靠自己。

Notion on Lotp的博客

我让 Coding Agent 帮我管 Notion 任务，学到了什么

问题

架构

第一个坎：我压根没写脚本