Prompt file imported from Basio0916/spec-driven-planning (
.codex/prompts/sdp-export-issues.prompt.md). Fill in{{slug}}before use. Copyright stays with the author.
SDP Export Issues
Export task breakdown to GitHub Issues, Jira Issues, or local markdown files.
Inputs
- slug: An existing requirement folder at
.sdp/specs/<slug>/containingtasks.yml - Usage Example:
/sdp-export-issues add-user-authentication - Export Config:
.sdp/config/export.yml(output destination, repository, labels)
Language Configuration
Read .sdp/config/language.yml to determine the output language:
- If
language: en, generate all content in English - If
language: ja, generate all content in Japanese
Console output should also be in the configured language.
Context Files
Read these for context:
.sdp/specs/{{slug}}/tasks.yml- Task breakdown to export.sdp/specs/{{slug}}/requirement.md- Original requirement.sdp/config/export.yml- Export configuration (destination, repo, labels)
Pre-Check
Before starting, verify that:
.sdp/specs/{{slug}}/directory exists.sdp/specs/{{slug}}/tasks.ymlfile exists.sdp/config/export.ymlfile exists
Report errors if files are missing.
Important: Configure Before Running
Before running this command, you MUST configure .sdp/config/export.yml:
- Set export destination: Choose
destination: githubordestination: local - Configure GitHub settings (if using GitHub mode):
- Set
github.repoto your repository (e.g., "owner/repo") - Customize
github.labelsas needed
- Set
- Configure local settings (if using local mode):
- Set
local.out_dirif different from default
- Set
User should review and edit .sdp/config/export.yml before proceeding.
Step 1: Load Export Configuration
Read .sdp/config/export.yml to determine:
destination: Export target (github,jira, orlocal)- Destination-specific settings (repository, project, labels, etc.)
issue_mode: How to organize taskssub_issues/sub_tasks: Create parent-child relationshipslinked_issues: Create separate issues with linkssingle_issue: Create one comprehensive issue with all tasks
Step 2: Determine Export Destination
Based on the destination field in export.yml:
github: Export to GitHub Issues (requiresghCLI)jira: Export to Jira Issues (uses REST API v3)backlog: Export to Backlog Issues (uses REST API v2)local: Export to local markdown files (no external tools required)
Implementation Details
For detailed implementation instructions, refer to:
- GitHub mode:
.sdp/docs/export-github.md - Jira mode:
.sdp/docs/export-jira.md - Backlog mode:
.sdp/docs/export-backlog.md - Local mode:
.sdp/docs/export-local.md
Step 3: Execute Export
GitHub Export
If destination: github, read .sdp/docs/export-github.md for complete implementation details.
Summary:
- Check
ghCLI availability and authentication - Check
gh sub-issueextension if needed - Create main issue using appropriate template
- Create task issues if using sub_issues or linked_issues mode
- Generate console output with issue URLs
Jira Export
If destination: jira, read .sdp/docs/export-jira.md for complete implementation details.
Summary:
- Check Jira configuration (url, email, project, API token)
- Load templates and convert Wiki Markup to ADF
- Create main issue via REST API
- Create task issues if using sub_tasks or linked_issues mode
- Generate console output with issue URLs
Backlog Export
If destination: backlog, read .sdp/docs/export-backlog.md for complete implementation details.
Summary:
- Check Backlog configuration (space_key, project_key, API key)
- Get project ID and issue type IDs via REST API
- Create main issue with Markdown description
- Create task issues if using sub_tasks or linked_issues mode
- Generate console output with issue URLs
Local Export
If destination: local, read .sdp/docs/export-local.md for complete implementation details.
Summary:
- Create output directory if needed
- Generate markdown file with issue drafts
- Generate console output with file path
Issue Templates
Issue Title Format
- Main issue:
[<slug>] <requirement title> - Task issue:
[<slug>][T-xxx] <task.title>
Issue Body Templates
Use templates from .sdp/templates/<lang>/:
issue-single.md- For single issue modeissue-main.md- For main requirement issueissue-task.md- For individual task issues
Replace placeholders with actual values from requirement and tasks files.
Console Output Format
After export completes, print a summary:
【エクスポート完了】
📋 要件: <slug>
🎯 エクスポート先: <destination>
📊 作成されたIssue数: <count>
Issue URL:
- メインIssue: <main_issue_url>
- タスクIssue:
- T-001: <task_issue_url>
- T-002: <task_issue_url>
...
💡 次のステップ:
- Issueボードで進捗を管理してください
- 必要に応じてタスクの優先順位を調整してください
Allowed Tools
Read, Write, Terminal, File Search, Grep
