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. 05Notionでの進捗管理

活用シーン

  1. 01機能実装の計画
  2. 02製品ローンチの調整
  3. 03システム移行計画の作成
  4. 04API開発の整理

インストール

コマンドをコピーしてターミナルで実行します。

$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. プロジェクトダッシュボードとステータスレポートを作成する
仕様から実装までのワークフロー
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

見積もりの単位

対応している所要時間の見積もり形式：

  • 時間
  • ストーリーポイント
  • 日
  • 週
  • プランニングポーカーの値（1、2、3、5、8、13、21）

関連項目

コメント

Markdown 対応