Column 1
Column 2
Notion 管结构化知识与追踪，Claude Code 管代码生成与执行。两者耦合形成闭环：思考在 Notion → 执行在终端 → 沉淀回 Notion。
1. 核心模型：双向信息流
阶段 | Notion 负责 | Claude Code 负责 |
需求 | PRD、验收标准、优先级 | 需求解析、方案生成 |
设计 | 架构图、接口文档 | 代码骨架、API stub |
编码 | CLAUDE.md 规范注入 | 实现、重构、测试 |
知识 | 踩坑记录、决策日志 | 代码注释、文档生成 |
追踪 | 看板、进度可视化 | Git commit、自动化脚本 |
一句话原则：Notion 是大脑（思考、规划、记忆），Claude Code 是双手（执行、分析、构建）。
2. 工作流 A：PRD 驱动开发
目标：在 Notion 写需求，Claude Code 直接消费并生成代码。
Step 1 — Notion：编写结构化 PRD
Step 2 — Claude Code：消费 PRD 生成代码
Step 3 — 回写 Notion
更新 PRD 页面验收标准 checkbox，附上 commit hash。
3. 工作流 B：知识库 → CLAUDE.md
目标：将 Notion 中的编码规范、踩坑记录转化为 CLAUDE.md，让 Claude Code 自动遵循。
Notion 侧：维护知识页面
- 📐 编码规范 — 命名、格式、注释标准
- 🐛 踩坑日志 — 问题 → 根因 → 解决方案
- 🏗️ 架构决策记录 (ADR) — 每次技术选型的 Why
CLAUDE.md：萃取核心规则（≤150 行）
关键原则：Notion 是知识的 Source of Truth，CLAUDE.md 是运行时快照。每周从 Notion 同步一次，保持精简。
4. 工作流 C：看板驱动任务执行
目标：Notion 数据库管理任务，Claude Code 逐任务执行。
Notion 任务数据库结构
属性 | 类型 | 说明 |
Task Name | Title | 任务描述 |
Status | Status | Todo → In Progress → Done |
Priority | Select | P0 / P1 / P2 |
Claude Prompt | Text | 给 Claude Code 的精确指令 |
Output | Text | 执行结果摘要 |
Claude Prompt 字段示例
日常节奏
- 晨会 — Notion 看板拖任务到 In Progress
- 编码 — 复制 Claude Prompt 到 Claude Code 执行
- 收工 — 产出摘要 + commit hash 回填 Notion，状态改 Done
5. 工作流 D：Bug 修复闭环
阶段 | 工具 | 动作 |
记录 | Notion | 创建 Bug 页面：现象、复现步骤、日志 |
分析 | Claude Code | 粘贴日志，生成假设并排序 |
修复 | Claude Code | 定位代码 → 修改 → 测试通过 |
沉淀 | Notion | 回写根因、修复方案、预防措施 |
防御 | 新踩坑点加入"已知陷阱" |
6. 数据共享：手动 vs MCP
方式一：手动（零配置）
方向 | 方法 | 操作 |
Notion → Claude Code | 复制粘贴 | 选中内容复制到终端 |
Notion → Claude Code | 导出 Markdown | 页面菜单 → Export → 存入 docs/ |
Notion → Claude Code | CLAUDE.md @import | @docs/spec.md 引用 |
Claude Code → Notion | 复制粘贴 | 终端输出贴入 Notion |
方式二：Notion MCP（推荐）
Claude Code 通过 MCP 直接读写 Notion，无需切换窗口。
配置（选其一）：
验证：在 Claude Code 中执行
/mcp，确认 notion 状态为 ✅ connected。使用示例：
封装为自定义命令（
.claude/commands/notion-task.md）：对比
维度 | 手动 | MCP |
配置成本 | 零 | 一次性 5 分钟 |
操作效率 | 需切换窗口 | 自然语言直接读写 |
回写可靠性 | 依赖人工记忆 | 可自动化 |
离线可用 | ✅ | ❌ |
推荐策略：MCP 为主、手动为辅。日常走 MCP 自动闭环，离线时用复制粘贴兜底。
7. 项目启动清单
新项目一键搭建共生环境：
Notion 侧
Claude Code 侧
同步节奏
频率 | 内容 |
每日 | Notion 取任务 → Claude Code 执行 → 回填产出 |
每周 | 新踩坑记录 + 规范变更同步到 CLAUDE.md |
每月 | 清理 CLAUDE.md 过时条目，更新 Notion ADR |
8. 反模式
Notion 里写代码 — Notion 无编译运行能力。只存接口定义和关键片段，代码在 Claude Code / IDE 中写。
Claude Code 里管需求 — 终端不适合多任务追踪。需求管理、看板、进度可视化是 Notion 的主场。
单向信息流 — 只输入不回写。每次 Claude Code 的产出都必须沉淀回 Notion，形成闭环。
