mcpField
S
spec-to-implementation

spec-to-implementation

github.com/tommy-ca开发6956 次安装51 周前更新
代码仓库

关于 spec-to-implementation

这项技能将项目需求整理为实施计划,在 Notion 中跟踪任务、估时、依赖关系和进度,适用于需要从规格走向执行的团队。

主要功能

  1. 01提取需求与验收标准
  2. 02拆分任务和用户故事
  3. 03识别依赖与风险
  4. 04估算工作量并分配负责人
  5. 05在 Notion 跟踪进度

适用场景

  1. 01规划功能实施
  2. 02协调产品发布
  3. 03制定系统迁移计划
  4. 04组织 API 开发

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tommy-ca/notion-skills --skill spec-to-implementation

安装后在 Claude Code 中输入/spec-to-implementation确认已加载。

附带文件evaluations/README.mdreference/task-breakdown-guide.md

详细介绍

概述

Spec-to-Implementation 技能可将项目规范转换为详细的实施计划,并在 Notion 中提供全面的任务拆分、时间估算和依赖关系跟踪。它弥合了需求与执行之间的差距。

适用场景

在以下情况下使用此技能:

  • 将项目规范转换为可执行的实施计划
  • 将复杂功能拆分为可实施的任务
  • 创建包含估算的详细项目时间表
  • 识别依赖关系和关键路径事项
  • 生成包含负责人和截止日期的任务清单
  • 在 Notion 中跟踪实施进度
  • 根据需求创建架构和技术规范

功能

  • 智能需求解析:自动提取需求和验收标准
  • 任务分解:将规范拆分为原子化、可实施的任务
  • 依赖关系映射:识别并可视化任务依赖关系
  • 工作量估算:为任务和里程碑提供时间估算
  • 负责人分配:清晰地分配任务
  • 进度跟踪:设置用于跟踪实施情况的 Notion 数据库
  • 风险识别:突出显示潜在的实施风险和阻碍因素

要求

  • Notion API 访问权限:用于创建实施计划和任务数据库
  • 规范格式:清晰的规范文档(Markdown、PDF 或文本)
  • 团队数据库:团队成员和技能目录(可选,但建议提供)
  • 项目模板:预先配置的 Notion 模板,以确保一致性

实施详情

此技能通过系统化流程转换规范:

  1. 解析规范文档并提取需求
  2. 将需求拆分为用户故事和任务
  3. 识别技术依赖关系和阻碍因素
  4. 按阶段创建详细的实施计划
  5. 估算每项任务的工作量
  6. 分配负责人并设置截止日期
  7. 在 Notion 中创建跟踪结构
  8. 生成项目仪表板和状态报告
Spec-to-Implementation 工作流
Specification Document
  ↓
Extract Requirements
  ↓
Break into User Stories
  ↓
Decompose into Tasks
  ↓
Identify Dependencies
  ↓
Estimate Effort
  ↓
Assign Ownership
  ↓
Create Notion Plan
  ↓
Output: Implementation Roadmap

示例用例

  1. 功能实施

    • 输入:包含需求的功能规范
    • 输出:包含时间表和负责人的任务拆分
    • 跟踪:Notion 中的进度仪表板
  2. 产品发布

    • 输入:产品规范和发布要求
    • 输出:包含阶段、依赖关系和关键路径的发布计划
    • 跟踪:多团队协作和里程碑
  3. 系统迁移

    • 输入:迁移规范和技术要求
    • 输出:分阶段的详细迁移计划
    • 跟踪:数据映射、系统切换和回滚流程
  4. 基础设施项目

    • 输入:基础设施设计规范
    • 输出:包含测试和部署阶段的实施计划
    • 跟踪:构建、测试和部署检查点
  5. API 开发

    • 输入:API 规范和端点要求
    • 输出:包含测试和文档工作的开发任务
    • 跟踪:开发进度和集成里程碑

任务层级

Epic (Feature)
  ├── User Story 1
  │   ├── Task 1.1 (Backend)
  │   ├── Task 1.2 (Frontend)
  │   └── Task 1.3 (Testing)
  ├── User Story 2
  │   └── [Tasks...]
  └── Acceptance Criteria

配置

NOTION_API_TOKEN=your_token_here
PROJECT_DATABASE_ID=your_database_id
TASK_DATABASE_ID=your_task_database_id
TEAM_DATABASE_ID=your_team_database_id
ESTIMATE_UNIT=hours

估算单位

支持的时间估算格式:

  • 小时
  • 故事点
  • 天
  • 周
  • Planning Poker 估算值(1、2、3、5、8、13、21)

另请参阅

评论

支持 Markdown