codex-sdd:tapd-openspec-proposal

TAPD OpenSpec Proposal

Overview

Use openspec_fetch_tapd_story from the main codex-sdd MCP server to fetch TAPD story content before calling openspec_create_change. In older installations that do not expose this tool, fall back to the project-local tapd-requirement:fetch_story MCP server. Treat TAPD as source material for scope, background, constraints, out-of-scope notes, and acceptance criteria.

Workflow

1. Extract TAPD input from the user message:
   • URL example: https://www.tapd.cn/tapd_fe/12345678/story/detail/1000000000000000001
   • Parsed workspace id: 12345678
   • Parsed story id: 1000000000000000001
2. Call MCP tool openspec_fetch_tapd_story with either:
   • { "url": "<tapd story url>" }
   • { "workspaceId": "<workspace id>", "storyId": "<story id>" }
   • If openspec_fetch_tapd_story is unavailable but tapd-requirement:fetch_story is available, call tapd-requirement:fetch_story with the same arguments.
3. Read proposalInput from the MCP response. If fields are missing, inspect raw for team custom fields, comments, or rich description fields.
4. Build the OpenSpec proposal input:
   • description: TAPD title plus requirement description.
   • background: TAPD business context, source URL, workspace id, story id, owner/status/priority if present.
   • outOfScope: Explicit TAPD non-goals only. If none are present, leave empty and do not invent exclusions.
   • Acceptance criteria: preserve TAPD criteria verbatim enough to avoid changing intent, then normalize into checkable bullets.
5. Before openspec_create_change, call openspec_detect_layout if available.
6. Call openspec_create_change with preset: "full".
7. Record the pre-proposal hook result with openspec_record_hook_result:
   • hookPoint: pre_proposal
   • hookName: openspec_fetch_tapd_story when the main MCP tool was used, or tapd-requirement:fetch_story for the fallback tool.
   • status: passed when TAPD content was fetched, failed when the MCP/API call failed, or skipped only after the user explicitly chooses to paste requirements manually.