仕様から実装へ

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 クライアントを有効にします：
   • 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 を使用します（コンテキスト、目的、受け入れ基準、依存関係、リソース）。
• プロパティを設定します：タイトル/行動動詞、ステータス、優先度、仕様 + 計画への関連付け、期限/ストーリーポイント/割り当て先（提供されている場合）。
• Notion:notion-create-pages を使用してデータベースの data_source_id でページを作成します。

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）。