用途:统一各模式下对 Notion 任务的更新方式,覆盖 PR 推送、初始化、状态变更及向任务页面追加内容等场景。
主要能力:
- 获取任务页面并核对当前字段值,再按上下文更新标准字段,如 Github PR link(url)、Branch name(rich_text)、Lifecycle/Status(select)。
- 向页面正文追加内容,包括实施计划、PR 摘要与状态更新;先读取现有区块,再追加 heading_2、paragraph 等区块。
- 同步 Session Journal:收集会话指标(时长、循环、返工、等待、RED 数、升级)及决策(KO、重要 OK)与学习(Kaizen/Hansei),按分支名查找现有会话,创建或更新会话页面,追加决策与学习区块,并与看板任务建立关联;若决策影响为 HIGH,则在 /docs/decisions/ 创建 ADR 文件并链接。
- 更新后再次检索页面确认同步成功,并输出同步摘要。
必要用法:通过 Notion MCP 工具调用完成,涉及 API-retrieve-a-page、API-get-block-children、API-patch-page、API-patch-block-children、API-post-page、API-post-search。该技能由 push-pr.mdc、init.mdc、需要 Notion 更新的模式或手动 sync session 命令调用。
适用场景:需要在开发流程中让 Notion 任务状态、PR 链接、分支名与会话记录保持一致时使用。
限制:运行依赖 Notion MCP 及相应数据库配置;需要提供有效的 task-page-id、SESSION_JOURNAL_DB_ID 等标识;资料未说明具体安装命令、收费方式或价格信息。