spec-import

Skill: import

Fetch external documents (via MCP or HTTP) and normalize them into the local SpecTeam workflow state.

Parameters

• $ARGUMENTS: The source URL (e.g., Notion page link) or MCP resource URI.

Execution Steps

Step 1 — Identity & pre-flight

1. Read git config spec.member-code to determine current identity {code}. Apply identity guard.
2. Run git status and display the result.

Step 2 — Fetch Content

1. If $ARGUMENTS is empty, output:

   ⚠️ Please provide an external document URL or MCP resource ID. Example: /spec-import https://notion.so/my-design-doc
   

   Stop execution.
2. Use available tools (e.g., MCP readResource, web fetch, or API calls) to retrieve the content of the specified $ARGUMENTS.
3. Convert the fetched content into Markdown format.

Step 3 — Normalize and Save

1. Generate a descriptive filename based on the content title (e.g., notion-auth-design.md).
2. Prepend the <!-- Spec Normalized Document --> header and metadata (Source URL, Import Date).
3. Save the file to .spec/design/{code}/{filename}.

Step 4 — Commit and Next Steps

1. Run git add .spec/design/{code}/{filename}.
2. Commit with message: "[SpecTeam] import — {code} imported external doc {filename}"
3. Automatically trigger /spec-parse to update the INDEX.md.
4. Output:

   ✅ External document successfully imported to .spec/design/{code}/{filename}
   Recommended next step: run /spec-review to check for divergences with other proposals.