[ PROMPT_NODE_26028 ]
notion-spec-to-implementation
[ SKILL_DOCUMENTATION ]
# 规格说明到实施 (Spec to Implementation)
将 Notion 规格说明转换为关联的实施计划、任务和持续的状态更新。
## 快速开始
1) 使用 `Notion:notion-search` 定位规格说明,然后使用 `Notion:notion-fetch` 获取它。
2) 使用 `reference/spec-parsing.md` 解析需求和模糊之处。
3) 使用 `Notion:notion-create-pages` 创建计划页面(选择模板:快速 vs. 完整)。
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) 链接工件
- 计划链接到规格说明;任务同时链接到计划和规格说明。
- 可选地,用简短的“实施”部分更新规格说明。