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 为规格说明添加简短的“实施”部分，指向计划和任务。

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）。