Notion ↔ 代码仓库双向桥接 · 工单系统

对接Notion现有「 半体工单 · Half-Body Orders」数据库 数据库ID: 05719bae-9e53-40f4-8233-6bf54551ac18 数据库URL: https://www.notion.so/663e4f29c7404d088f3a02fcc70b1418


现有数据库结构

字段 类型 说明
任务标题 Title 工单标题
状态 Select 待开发·开发中·自检中·待审查·审核中·已完成·暂缓
优先级 Select P0·P1·P2
负责Agent Select 译典A05·培园A04·录册A02·霜砚Web·铸渊
编号 Text 工单编号
分支名 Text Git分支名
仓库路径 Text 仓库目标路径
开发内容 Text 详细描述
约束 Text 规范约束
阶段编号 Text Phase编号
自检结果 Text Agent自检
审核结果 Text 霜砚审核
下一轮指引 Text 完成后触发
创建时间 Date 自动

同步流程

Notion霜砚/知秋/其他Agent         代码仓库(铸渊)
  │                                      │
  ├─ 创建/更新工单                       ├─ sync-ticket.py 轮询
  │  · 任务标题、状态、优先级             │  · 每30分钟查Notion
  │  · 负责Agent、开发内容               │  · 检测新工单/状态变更
  │  · 分支名、仓库路径                  │  · 同步到Forgejo Issue
  │                                      │
  └─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ →    ├─ 铸渊醒来 → 读取Issue
      霜砚:审核结果更新                   │  → 处理 → 推代码
      知秋:创建新工单                    │  → 更新工单状态
      译典/培园/录册:开发中              │
                                          └─ → 写回Notion
                                              铸渊:处理结果
                                              状态:自检中

配置方式

# 在服务器上
cd /opt/guanghulab-repo/notion

# 设置Notion API token来自WorkBuddy的Notion集成
export NOTION_TOKEN="1d4d872b-594c-815e-8cfd-0002d22415e8:rYkVgBbnSvHe4GyE:B2CeHHv9LA_jMXlTuwMxahyky_oLdblC"
export NOTION_DATABASE_ID="05719bae-9e53-40f4-8233-6bf54551ac18"

# 启动同步
pm2 start sync-ticket.py --name notion-ticket-sync

# 查看日志
pm2 logs notion-ticket-sync

铸渊的工单工作流

  1. 醒来读工单检查Notion工单数据库中状态为「待开发」且负责Agent不指定的工单
  2. 领取工单将工单状态改为「开发中」负责Agent标注铸渊
  3. 开发:按工单的分支名、仓库路径、开发内容执行
  4. 自检:完成后填写自检结果
  5. 标记状态:改为「自检中」
  6. 霜砚审核霜砚在Notion中审核→审核结果写入→状态改为「待审查」/「已完成」

Notion ↔ 代码仓库桥接 · v1.1 · 对接现有半体工单数据库 · D110