mcpField
N
notion-spec-to-implementation

notion-spec-to-implementation

github.com/openai開発28.4k3.2k 回インストール18 週間前に更新
リポジトリ

notion-spec-to-implementation について

Notionの仕様を相互に関連付けた実装計画とタスクにまとめ、進捗を追跡するスキルです。要件の整理から成果物のリンク、状況更新までを扱います。

主な機能

  1. 01Notion仕様の検索と解析
  2. 02簡易・詳細計画テンプレート
  3. 03データベース属性付きタスク作成
  4. 04仕様・計画・タスクの相互リンク
  5. 05進捗とマイルストーンの更新

活用シーン

  1. 01Notion仕様から実装計画を作成
  2. 02機能や移行作業をタスクに分割
  3. 03実装状況を計画に合わせて更新

MCP 対応

Notion MCPツールで仕様を検索・取得し、計画やタスクのページ作成、ページ状態の更新を行います。

インストール

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

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

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
assets/
notion-small.svg
evaluations/
basic-spec-implementation.json
README.md
spec-to-tasks.json
examples/
api-feature.md
database-migration.md
ui-component.md
reference/
milestone-summary-template.md
progress-tracking.md
progress-update-template.md
quick-implementation-plan.md
spec-parsing.md
standard-implementation-plan.md
task-creation-template.md
task-creation.md

詳細

仕様から実装へ

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) Notion MCP が接続されていないために MCP 呼び出しが失敗した場合は、作業を一時停止してセットアップします。
  1. Notion MCP を追加します。
    • codex mcp add notion --url https://mcp.notion.com/mcp
  2. リモート MCP クライアントを有効にします。
    • [features].rmcp_client = true を config.toml に設定するか、codex --enable rmcp_client を実行します。
  3. OAuth でログインします。
    • codex mcp login notion

ログインに成功すると、ユーザーは codex を再起動する必要があります。再試行時に Step 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 対応