仕様から実装へ
Notionの仕様書を、リンクされた実装計画、タスク、そして継続的なステータス更新に変換します。
クイックスタート
Notion:notion-searchで仕様書を見つけ、Notion:notion-fetchで取得します。reference/spec-parsing.mdを使用して要件と曖昧な点を解析します。Notion:notion-create-pagesで計画ページを作成します(テンプレートを選択:クイック vs フル)。- タスクデータベースを見つけ、スキーマを確認してから、
Notion:notion-create-pagesでタスクを作成します。 - 仕様 ↔ 計画 ↔ タスクをリンクし、
Notion:notion-update-pageでステータスを最新に保ちます。
ワークフロー
0) MCP呼び出しがNotion MCP未接続で失敗した場合、一時停止してセットアップを行います:
- Notion MCPを追加します:
codex mcp add notion --url https://mcp.notion.com/mcp
- リモートMCPクライアントを有効にします:
config.tomlで[features].rmcp_client = trueを設定 またはcodex --enable rmcp_clientを実行します。
- 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)。