用途
speckit-taskstoissues 用于将 Spec Kit 流程中已生成的任务清单,转换为 GitHub 上可执行、且按依赖关系排序的 Issue,帮助团队把设计文档与任务计划直接落到 Issue 跟踪系统中。
主要能力
- 读取现有任务产物并据此创建 GitHub Issue,Issue 与功能对应。
- 依据任务之间的依赖顺序组织 Issue,使其具备执行先后关系。
- 基于可用的设计产物(如 FEATURE_DIR 与 AVAILABLE_DOCS)为功能创建 Issue。
- 若存在 .specify/memory/constitution.md,则加载项目原则与治理约束。
- 支持扩展钩子:执行前检查 hooks.before_taskstoissues,执行后检查 hooks.after_taskstoissues;hook 中 enabled 显式为 false 时跳过,未写 enabled 视为启用;无 condition 或 condition 为空时视为可执行,非空 condition 交由 HookExecutor 处理。
- 将 hook 命令名中的点替换为连字符构造斜杠命令,例如 speckit.git.commit → /speckit-git-commit。
- 可选钩子输出提示与执行命令;强制钩子自动执行并等待结果后再继续。
使用方式
- 在项目根目录运行 .specify/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks,解析 FEATURE_DIR 与 AVAILABLE_DOCS,路径需为绝对路径。
- 如存在 .specify/extensions.yml,检查并处理 before_taskstoissues 钩子。
- 加载 .specify/memory/constitution.md(如存在)。
- 从脚本结果中提取任务清单路径,并通过 git config --get remote.origin.url 获取 Git 远程地址。
- 仅在远程为 GitHub URL 时,使用 GitHub MCP 服务器在对应仓库中为每个任务创建 Issue。
- 处理 after_taskstoissues 钩子。
适用场景
适用于已使用 Spec Kit 生成任务与设计产物、并希望把这些任务同步为 GitHub Issue 的团队,尤其是需要按依赖顺序拆分工作、用 Issue 跟踪功能实现进度的项目。
限制
- 仅在 Git 远程为 GitHub URL 时继续创建 Issue。
- 不在与远程 URL 不匹配的仓库中创建 Issue。
- 扩展钩子的 condition 表达式不由该技能解释,交由 HookExecutor 实现。
- YAML 无法解析或无效时,跳过钩子检查并继续。
- 依赖 PowerShell 脚本 check-prerequisites.ps1 与 GitHub MCP 服务器。