Claude Code 日志插件：一眼看清 Notion 会话摘要
来源：dev.to — 2026-09-02
📋 概述
作者把之前写的 /journal skill 包装成任何人可安装的 Claude Code 插件（cseeman/claude-journal）：每段工作会话后，它找到或创建 Notion 工作日志里的今天页面，追加这段会话的摘要。与三个月前每天手写的旧版相比，新版把每次运行的三次 Notion 调用、按季节上色、按星期显示图标的 callout 讲得清清楚楚，并透露了一个意外的发现——一个作者每天运行了三个月的 skill，内部插件专家评审竟从中找出两个长期静默的 bug：月视图调用漏了必填参数、两个写工具默认异步导致校验可能跑在写入落地之前。
🔑 核心要点
- 入口格式有硬规则：粗体标题用过去时陈述结果、元数据行用标识符作链接文本引用每个 ticket/PR/分支、最多四条单句 bullet、follow-up 单独一行用 Next:/Open: 前缀，约 80 词
- 作者最在意的一条规则是禁止叙述式推理——像「与其交付 drive-by 不如…」这类自我辩护的句子被整段剔除，真正重要的理由应变成一条以事实陈述的 bullet
- 背景色按季节（蓝绿黄橙）、图标按星期（月剑羽闪电樱土日）——都由 skill 加载前运行的 shell 脚本算好，模型拿到成品值不再查表，既省时又让一屏日志有了时间感
- 评审找出的 bug 之前从未报错：月视图调用 Notion view 工具漏了必填参数，三个月来全靠模型每次从上下文猜；两个写工具默认异步导致校验可能跑在写入前
- 个人版原本根本不可共享——数据库 id 与 MCP server 别名全硬编码，把这些移进 shell 脚本读取的配置文件就花了一小时，换来任何人可用
- skill 从 123 行精简到 97 行，留下的每一行都是模型写摘要时会真正执行的指令
💡 金句
写着「这样没问题」的注释，是阻止任何人检查它是否有问题的最廉价方式。
👍 0
👎 0
← 返回 dev.to 首页