mcpField
N
notion-spec-to-implementation

notion-spec-to-implementation

github.com/davila7生産性33.0k350 回インストール1 日前に更新
リポジトリ

notion-spec-to-implementation について

Notionの仕様書を、相互に関連付けた実装計画とタスクに変換するワークフロースキルです。進捗や関連ページの状態を同期する手順も扱います。

主な機能

  1. 01Notion仕様書の検索と解析
  2. 02実装計画ページの作成
  3. 03データベースタスクの作成と関連付け
  4. 04進捗追跡とステータス更新

活用シーン

  1. 01機能仕様書から作業計画を作成
  2. 02移行作業をタスクに分割
  3. 03計画とタスクの状態を同期

MCP 対応

Notion MCPで仕様書を検索・取得し、計画やタスクのページを作成してページを更新します。Notion MCPが未接続の場合の設定手順も含みます。

インストール

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

$npx skills add https://github.com/davila7/claude-code-templates --skill notion-spec-to-implementation

インストール後、Claude Code で/notion-spec-to-implementationを入力して読み込まれたか確認します。

詳細

Spec から実装へ

Notion の仕様書を、リンクされた実装計画、タスク、継続的なステータス更新に変換します。

クイックスタート

  1. Notion:notion-search で仕様書を探し、Notion:notion-fetch で取得します。
  2. reference/spec-parsing.md を使って、要件と曖昧な点を解析します。
  3. Notion:notion-create-pages で計画ページを作成します（テンプレートを選択：クイック版か完全版）。
  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) 成果物をリンクする
  • 計画は仕様書にリンクします。タスクは計画と仕様書の両方にリンクします。
  • 任意で、Notion:notion-update-page を使い、計画とタスクを指す短い「実装」セクションを仕様書に追加します。
5) 進捗を追跡する
  • reference/progress-tracking.md の頻度に従います。
  • reference/progress-update-template.md を使って進捗を投稿し、reference/milestone-summary-template.md を使ってフェーズを締めくくります。
  • 計画とタスクのチェックリストとステータスフィールドを同期させ、ブロッカーや決定事項を記録します。

参考資料と例

  • reference/ — 解析パターン、計画／タスクのテンプレート、進捗の頻度（例：spec-parsing.md、standard-implementation-plan.md、task-creation.md、progress-tracking.md）。
  • examples/ — エンドツーエンドの解説（例：ui-component.md、api-feature.md、database-migration.md）。

コメント

Markdown 対応