notion-spec-to-implementation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Spec to Implementation

从需求规格到落地实施

Convert a Notion spec into linked implementation plans, tasks, and ongoing status updates.

将Notion需求规格文档转化为相互关联的实施计划、任务以及持续的状态更新。

Quick start

快速开始

Locate the spec with
```
Notion:notion-search
```
, then fetch it with
```
Notion:notion-fetch
```
.
Parse requirements and ambiguities using
```
reference/spec-parsing.md
```
.
Create a plan page with
```
Notion:notion-create-pages
```
(pick a template: quick vs. full).
Find the task database, confirm schema, then create tasks with
```
Notion:notion-create-pages
```
.
Link spec ↔ plan ↔ tasks; keep status current with
```
Notion:notion-update-page
```
.

使用
```
Notion:notion-search
```
定位需求规格文档，再通过
```
Notion:notion-fetch
```
获取文档内容。
参考
```
reference/spec-parsing.md
```
解析需求与模糊点。
通过
```
Notion:notion-create-pages
```
创建计划页面（选择模板：快速版 vs 完整版）。
找到任务数据库，确认 schema 后，使用
```
Notion:notion-create-pages
```
创建任务。
建立需求规格 ↔ 计划 ↔ 任务之间的关联；通过
```
Notion:notion-update-page
```
保持状态同步。

Workflow

工作流程

0) If any MCP call fails because Notion MCP is not connected, pause and set it up:

0) 若因未连接Notion MCP导致MCP调用失败，请暂停并完成以下设置：

Add the Notion MCP:

codex mcp add notion --url https://mcp.notion.com/mcp

Enable remote MCP client:

Set

[features].rmcp_client = true

config.toml

or run

codex --enable rmcp_client

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

添加Notion MCP：

codex mcp add notion --url https://mcp.notion.com/mcp

启用远程MCP客户端：

在

config.toml

中设置

[features].rmcp_client = true

或运行

codex --enable rmcp_client

通过OAuth登录：
- ```
codex mcp login notion
```

登录成功后，用户需要重启codex。你应完成当前回答并告知用户，当他们再次尝试时即可继续执行步骤1。

1) Locate and read the spec

1) 定位并读取需求规格文档

Search first (
```
Notion:notion-search
```
); if multiple hits, ask the user which to use.
Fetch the page (
```
Notion:notion-fetch
```
) and scan for requirements, acceptance criteria, constraints, and priorities. See
```
reference/spec-parsing.md
```
for extraction patterns.
Capture gaps/assumptions in a clarifications block before proceeding.

先进行搜索（
```
Notion:notion-search
```
）；若有多个结果，请询问用户选择哪一个。
获取页面内容（
```
Notion:notion-fetch
```
），并扫描其中的需求、验收标准、约束条件和优先级。提取规则可参考
```
reference/spec-parsing.md
```
。
在继续之前，将存在的缺口/假设记录在澄清模块中。

2) Choose plan depth

2) 选择计划详细程度

Simple change → use
```
reference/quick-implementation-plan.md
```
.

Multi-phase feature/migration → use

reference/standard-implementation-plan.md

Create the plan via
```
Notion:notion-create-pages
```
, include: overview, linked spec, requirements summary, phases, dependencies/risks, and success criteria. Link back to the spec.

简单变更 → 使用
```
reference/quick-implementation-plan.md
```
模板。
多阶段功能/迁移 → 使用
```
reference/standard-implementation-plan.md
```
模板。
通过
```
Notion:notion-create-pages
```
创建计划页面，内容应包含：概述、关联的需求规格文档、需求摘要、实施阶段、依赖项/风险以及成功标准。并建立回连到需求规格文档的链接。

3) Create tasks

3) 创建任务

Find the task database (
```
Notion:notion-search
```
→
```
Notion:notion-fetch
```
to confirm the data source and required properties). Patterns in
```
reference/task-creation.md
```
.
Size tasks to 1–2 days. Use
```
reference/task-creation-template.md
```
for content (context, objective, acceptance criteria, dependencies, resources).
Set properties: title/action verb, status, priority, relations to spec + plan, due date/story points/assignee if provided.

Create pages with

Notion:notion-create-pages

using the database’s

data_source_id

找到任务数据库（
```
Notion:notion-search
```
→
```
Notion:notion-fetch
```
确认数据源和所需属性）。任务创建规则可参考
```
reference/task-creation.md
```
。
任务粒度控制在1-2天内完成。使用
```
reference/task-creation-template.md
```
生成任务内容（背景、目标、验收标准、依赖项、资源）。
设置属性：标题/动作动词、状态、优先级、与需求规格+计划的关联关系、截止日期/故事点数/负责人（若有提供）。
使用数据库的
```
data_source_id
```
，通过
```
Notion:notion-create-pages
```
创建任务页面。

4) Link artifacts

4) 关联各工件

Plan links to spec; tasks link to both plan and spec.
Optionally update the spec with a short “Implementation” section pointing to the plan and tasks using
```
Notion:notion-update-page
```
.

计划页面链接到需求规格文档；任务页面链接到计划页面和需求规格文档。
（可选）通过
```
Notion:notion-update-page
```
在需求规格文档中添加一个简短的“落地实施”板块，指向对应的计划和任务页面。

5) Track progress

5) 跟踪进度

Use the cadence in
```
reference/progress-tracking.md
```
.

Post updates with

reference/progress-update-template.md

; close phases with

reference/milestone-summary-template.md

Keep checklists and status fields in plan/tasks in sync; note blockers and decisions.

参考
```
reference/progress-tracking.md
```
中的节奏要求。

使用

reference/progress-update-template.md

发布更新；使用

reference/milestone-summary-template.md

完成阶段收尾。

保持计划/任务中的检查清单和状态字段同步；记录阻塞问题与决策结果。

References and examples

参考资料与示例

reference/

— parsing patterns, plan/task templates, progress cadence (e.g.,

spec-parsing.md

standard-implementation-plan.md

task-creation.md

progress-tracking.md

examples/

— end-to-end walkthroughs (e.g.,

ui-component.md

api-feature.md

database-migration.md

reference/

— 解析规则、计划/任务模板、进度节奏（例如

spec-parsing.md

、

standard-implementation-plan.md

、

task-creation.md

、

progress-tracking.md

）。

examples/

— 端到端演练示例（例如

ui-component.md

、

api-feature.md

、

database-migration.md

）。