notion-spec-to-implementation

规格说明到实现

将规格说明转换为可执行的实施计划，并跟踪进度。获取规格说明文档、提取需求、拆分任务，并管理实施工作流。

快速开始

收到实施规格说明的请求时：

1. 查找规格说明：使用 Notion:notion-search 定位规格说明页面
2. 获取规格说明：使用 Notion:notion-fetch 读取规格说明内容
3. 提取需求：解析并整理规格说明中的需求
4. 创建计划：使用 Notion:notion-create-pages 创建实施计划
5. 查找任务数据库：使用 Notion:notion-search 定位任务数据库
6. 创建任务：使用 Notion:notion-create-pages 在任务数据库中创建单项任务
7. 跟踪进度：使用 Notion:notion-update-page 记录进度并更新状态

实施工作流

步骤 1：查找规格说明

1. Search for spec:
   - Use Notion:notion-search with spec name or topic
   - Apply filters if needed (e.g., created_date_range, teamspace_id)
   - Look for spec title or keyword matches
   - If not found or ambiguous, ask user for spec URL/ID

Example searches:
- "User Authentication spec"
- "Payment Integration specification"
- "Mobile App Redesign PRD"

步骤 2：获取并分析规格说明

1. Fetch spec page:
   - Use Notion:notion-fetch with spec URL/ID from search results
   - Read full content including requirements, design, constraints

2. Parse specification:
   - Identify functional requirements
   - Note non-functional requirements (performance, security, etc.)
   - Extract acceptance criteria
   - Identify dependencies and blockers

有关解析模式，请参阅 reference/spec-parsing.md。

步骤 3：创建实施计划

1. Break down into phases/milestones
2. Identify technical approach
3. List required tasks
4. Estimate effort
5. Identify risks

Use implementation plan template (see [reference/standard-implementation-plan.md](reference/standard-implementation-plan.md) or [reference/quick-implementation-plan.md](reference/quick-implementation-plan.md))

步骤 4：创建实施计划页面

Use Notion:notion-create-pages:
- Title: "Implementation Plan: [Feature Name]"
- Content: Structured plan with phases, tasks, timeline
- Link back to original spec
- Add to appropriate location (project page, database)

步骤 5：查找任务数据库

1. Search for task database:
   - Use Notion:notion-search to find "Tasks" or "Task Management" database
   - Look for engineering/project task tracking system
   - If not found or ambiguous, ask user for database location

2. Fetch database schema:
   - Use Notion:notion-fetch with database URL/ID
   - Get property names, types, and options
   - Identify correct data source from <data-source> tags
   - Note required properties for new tasks

步骤 6：创建实施任务

For each task in plan:
1. Create task in task database using Notion:notion-create-pages
2. Use parent: { data_source_id: 'collection://...' }
3. Set properties from schema:
   - Name/Title: Task description
   - Status: To Do
   - Priority: Based on criticality
   - Related Tasks: Link to spec and plan
4. Add implementation details in content

有关任务模式，请参阅 reference/task-creation.md。

步骤 7：开始实施

1. Update task status to "In Progress"
2. Add initial progress note
3. Document approach and decisions
4. Link relevant resources

步骤 8：跟踪进度

Regular updates:
1. Update task properties (status, progress)
2. Add progress notes with:
   - What's completed
   - Current focus
   - Blockers/issues
3. Update implementation plan with milestone completion
4. Link to related work (PRs, designs, etc.)

有关跟踪模式，请参阅 reference/progress-tracking.md。

规格说明分析模式

功能需求：用户故事、功能描述、工作流、数据需求、集成点

非功能需求：性能目标、安全要求、可扩展性需求、可用性、合规性

验收标准：可测试的条件、用户验证点、性能基准、完成定义

有关详细的解析技巧，请参阅 reference/spec-parsing.md。

实施计划结构

计划包括：概览 → 关联的规格说明 → 需求摘要 → 技术方案 → 实施阶段（目标、任务清单、预估工作量）→ 依赖项 → 风险与缓解措施 → 时间线 → 成功标准

有关完整的计划模板，请参阅 reference/standard-implementation-plan.md。

任务拆分模式

按组件拆分：数据库、API 端点、前端组件、集成、测试 按功能切片拆分：垂直切片（身份验证流程、数据录入、报告生成） 按优先级拆分：P0（必须具备）、P1（重要）、P2（锦上添花）

进度记录

每日更新（工作进行中）：添加进度说明，列出已完成事项、当前重点和阻碍因素 里程碑更新（取得重大进展时）：更新计划复选框，添加里程碑摘要，调整时间线 状态变更（任务状态转换时）：更新属性（进行中 → 审核中 → 已完成），添加完成说明，关联交付成果

进度格式：日期标题 → 已完成 → 进行中 → 后续步骤 → 阻碍因素 → 备注

有关详细模式，请参阅 reference/progress-tracking.md。

将规格说明关联到实施

正向链接：在规格说明页面中添加“实施”部分，链接到计划和任务 反向链接：在计划和任务中通过“规格说明”部分引用规格说明 双向可追溯性：维护两个方向的链接，便于跟踪

实施状态跟踪

计划状态：根据阶段完成情况更新（✅ 已完成、🔄 进行中 %、⏳ 尚未开始），并更新总体百分比 任务汇总：按计划 ID 查询任务数据库，生成摘要（已完成、进行中、受阻、尚未开始）

处理规格变更

检测：获取更新后的规格 → 与计划进行比较 → 识别新增要求 → 评估影响 传播：更新计划 → 创建新任务 → 更新受影响的任务 → 添加变更说明 → 通过评论通知 变更日志：记录规格演变，包括日期、变更内容和影响

常见模式

功能标志：后端（置于标志后）→ 测试 → 前端（启用标志）→ 内部推出 → 对外推出 数据库迁移：架构设计 → 迁移脚本 → 预发布环境测试 → 生产环境迁移 → 验证 API 开发：API 设计 → 后端实现 → 测试和文档 → 客户端集成 → 部署

最佳实践

1. 始终关联规格与实现：维护双向引用
2. 拆分为小任务：每个任务应能在 1-2 天内完成
3. 提取明确的验收标准：明确何为“完成”
4. 尽早识别依赖项：在计划中注明阻塞项
5. 定期更新进度：为正在进行的工作每日记录进展
6. 跟踪变更：记录规格更新及其影响
7. 使用检查清单：可视化进度指标有助于所有人掌握进展
8. 关联交付成果：PR、设计和文档应关联回任务

高级功能

如需了解更多实现模式和技巧，请参阅 reference/ 中的参考文件。

常见问题

“找不到规格”：使用 Notion:notion-search 搜索规格名称/主题，尝试更宽泛的关键词，或向用户索要 URL “找到多个规格”：询问用户要实现哪一项，或展示选项 “找不到任务数据库”：搜索“Tasks”或“Task Management”，或询问用户数据库位置 “规格不明确”：在计划中注明歧义，并创建澄清任务 “要求相互冲突”：记录冲突，并创建决策任务 “范围过大”：拆分为更小的规格/阶段

示例

完整工作流请参阅 examples/：

• examples/api-feature.md - API 功能实现
• examples/ui-component.md - 前端组件
• examples/database-migration.md - 架构变更