ComposioHQ/notion-spec-to-implementation

Notionの仕様書を実装計画、タスク、進捗管理に変換します。PRDや機能仕様の実装時、Notion上での計画作成とタスク管理に使用します。

notion-spec-to-implementation とは?

このスキルは、Notion上に書かれた仕様書(PRDや機能仕様)を、実行可能な実装計画とタスクに変換するためのワークフローを提供します。主にClaude CodeやCodexなどのAIエージェント向けに設計されており、Notion MCP(Model Context Protocol)を介してNotionと連携します。開発者は、スキルが提供するステップに従うことで、仕様の解析、実装計画の作成、タスクの生成、成果物間のリンク、そして進捗管理を自動化できます。特に、複雑な機能やマイグレーションなど、複数フェーズにわたる作業を効率的に管理するのに役立ちます。スキルは「クイック」と「フル」の2つのテンプレートを提供し、タスクは1〜2日単位で分割することを推奨しています。Notion MCPのセットアップ方法も含まれており、すぐに使い始められます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComposioHQ/awesome-codex-skills/tree/main/notion-spec-to-implementation

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

仕様から実装へ

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

クイックスタート

  1. Notion:notion-search で仕様書を見つけ、Notion:notion-fetch で取得します。
  2. reference/spec-parsing.md を使用して要件と曖昧な点を解析します。
  3. Notion:notion-create-pages で計画ページを作成します(テンプレートを選択:クイック vs フル)。
  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)。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComposioHQ/-21risk-automation

Automate 21risk tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/-2chat-automation

Automate 2chat tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/ably-automation

Automate Ably tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/abstract-automation

Automate Abstract tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/abuselpdb-automation

Automate Abuselpdb tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/abyssale-automation

Automate Abyssale tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/accelo-automation

Automate Accelo tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/accredible-certificates-automation

Automate Accredible Certificates tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/acculynx-automation

Automate Acculynx tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/active-campaign-automation

Automate ActiveCampaign tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/addresszen-automation

Automate Addresszen tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/adobe-automation

Automate Adobe tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/adrapid-automation

Automate Adrapid tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/adyntel-automation

Automate Adyntel tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/aeroleads-automation

Automate Aeroleads tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/aero-workflow-automation

Automate Aero Workflow tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/affinda-automation

Automate Affinda tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/affinity-automation

Automate Affinity tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/agencyzoom-automation

Automate Agencyzoom tasks via Rube MCP (Composio). Always search tools first for current schemas.

ComposioHQ/agent-deep-links

Build, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools. Use when users ask for clickable links (especially in Slack) that open threads, files, folders, or app settings.

関連スキル