notion-spec-to-implementation

规格到实现

将 Notion 规格转换为相互关联的实现计划、任务和持续状态更新。

快速开始

1. 使用 Notion:notion-search 查找规格，然后使用 Notion:notion-fetch 获取内容。
2. 使用 reference/spec-parsing.md 解析需求和歧义。
3. 使用 Notion:notion-create-pages 创建计划页面（选择模板：快速版或完整版本）。
4. 查找任务数据库并确认其架构，然后使用 Notion:notion-create-pages 创建任务。
5. 关联规格 ↔ 计划 ↔ 任务；使用 Notion:notion-update-page 保持状态为最新。

工作流

0) 如果任何 MCP 调用因 Notion MCP 未连接而失败，请暂停并进行设置：

1. 添加 Notion MCP：
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. 启用远程 MCP 客户端：
   • 在 config.toml 中设置 [features].rmcp_client = true，或运行 codex --enable rmcp_client
3. 使用 OAuth 登录：
   • codex mcp login notion

成功登录后，用户需要重启 codex。请先完成回复并告知用户，这样他们下次尝试时就能从第 1 步继续。

1) 查找并阅读规格

• 先搜索（Notion:notion-search）；如果有多个结果，请询问用户要使用哪一个。
• 获取页面（Notion:notion-fetch），并查看需求、验收标准、约束和优先级。提取模式请参阅 reference/spec-parsing.md。
• 在继续之前，将待补充信息／假设记录在澄清事项区块中。

2) 选择计划详略

• 简单变更 → 使用 reference/quick-implementation-plan.md。
• 多阶段功能／迁移 → 使用 reference/standard-implementation-plan.md。
• 通过 Notion:notion-create-pages 创建计划，内容包括：概述、关联规格、需求摘要、阶段、依赖项／风险和成功标准。添加返回规格的链接。

3) 创建任务

• 查找任务数据库（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) 关联项目产物

• 计划关联规格；任务同时关联计划和规格。
• 也可以使用 Notion:notion-update-page 在规格中添加简短的“Implementation”章节，指向计划和任务。

5) 跟踪进度

• 按照 reference/progress-tracking.md 中的频率更新。
• 使用 reference/progress-update-template.md 发布更新；使用 reference/milestone-summary-template.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）。