SuperAPI AI 工具集

speckit-taskstoissues

智能体与模型

查看项目

更新于 10-24 10:10

技能介绍

用途

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。
  • 可选钩子输出提示与执行命令;强制钩子自动执行并等待结果后再继续。

使用方式

  1. 在项目根目录运行 .specify/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks,解析 FEATURE_DIR 与 AVAILABLE_DOCS,路径需为绝对路径。
  2. 如存在 .specify/extensions.yml,检查并处理 before_taskstoissues 钩子。
  3. 加载 .specify/memory/constitution.md(如存在)。
  4. 从脚本结果中提取任务清单路径,并通过 git config --get remote.origin.url 获取 Git 远程地址。
  5. 仅在远程为 GitHub URL 时,使用 GitHub MCP 服务器在对应仓库中为每个任务创建 Issue。
  6. 处理 after_taskstoissues 钩子。

适用场景

适用于已使用 Spec Kit 生成任务与设计产物、并希望把这些任务同步为 GitHub Issue 的团队,尤其是需要按依赖顺序拆分工作、用 Issue 跟踪功能实现进度的项目。

限制

  • 仅在 Git 远程为 GitHub URL 时继续创建 Issue。
  • 不在与远程 URL 不匹配的仓库中创建 Issue。
  • 扩展钩子的 condition 表达式不由该技能解释,交由 HookExecutor 实现。
  • YAML 无法解析或无效时,跳过钩子检查并继续。
  • 依赖 PowerShell 脚本 check-prerequisites.ps1 与 GitHub MCP 服务器。