specification-executor

从规范到实现

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

快速开始

收到实现规范的请求时：

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 - 模式变更