Back to Details

speckit-taskstoissues

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Spec Kit Tasks-to-Issues Skill

Spec Kit 任务转Issues技能

When to Use

使用场景

  • You want to convert 
    tasks.md
    into GitHub issues in the same repository.
  • 你需要将
    tasks.md
    转换为同一仓库中的GitHub issues。

Inputs

输入项

  • specs/<feature>/tasks.md
  • The repository's Git remote URL
  • Any user-provided issue labeling or grouping preferences
If tasks are missing, ask the user to run speckit-tasks first.
  • specs/<feature>/tasks.md
    文件
  • 仓库的Git远程URL
  • 用户提供的任何issue标签或分组偏好
如果缺少任务，请先让用户运行speckit-tasks。

Workflow

工作流程

  1. Run 
    .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
    from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'''m Groot' (or double-quote if possible: "I'm Groot").
  2. From the executed script, extract the path to tasks.
  3. Get the Git remote by running:
bash
git config --get remote.origin.url
[!CAUTION] ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL
  1. For each task in the list, create a new issue in the repository that matches the Git remote.
    • Prefer a GitHub issue-writing tool if available (e.g., MCP server or 
      gh issue create
      ).
    • Keep titles concise and include the task ID in the issue body for traceability.
[!CAUTION] UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
  1. 从仓库根目录运行
    .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
    ，并解析FEATURE_DIR和AVAILABLE_DOCS列表。所有路径必须为绝对路径。对于参数中的单引号（如"I'm Groot"），请使用转义语法：例如'I'''m Groot'（或尽可能使用双引号："I'm Groot"）。
  2. 从执行的脚本中提取任务的路径。
  3. 通过运行以下命令获取Git远程地址：
bash
git config --get remote.origin.url
[!CAUTION] 仅当远程地址为GitHub URL时，才继续执行后续步骤
  1. 针对列表中的每个任务，在与Git远程地址匹配的仓库中创建一个新的issue。
    • 如果有可用的GitHub issue编写工具（如MCP server或
      gh issue create
      ），优先使用。
    • 标题需简洁，并在issue正文中包含任务ID以确保可追溯性。
[!CAUTION] 无论在任何情况下，都不得在与远程地址不匹配的仓库中创建issues

Outputs

输出结果

  • GitHub issues created from 
    tasks.md
    (one per task), in the repository matching the Git remote
  • 从
    tasks.md
    生成的GitHub issues（每个任务对应一个），存储在与Git远程地址匹配的仓库中