Communitygithub.com

任务转议题(GitHub)

将现有任务转化为按依赖关系排序、可执行的 GitHub Issue,基于可用的设计产物。

任务转议题(GitHub) 是什么?

该技能(skill)将项目中已有的 `tasks.md` 文件中的任务自动转化为 GitHub Issues。它首先通过 `check-prerequisites.sh` 脚本获取任务列表和设计文档位置,读取 `.specify/memory/constitution.md`(如果存在)作为项目原则约束,并获取 Git 远程 URL 确认仓库为 GitHub 仓库。然后,它通过 GitHub MCP 服务器获取现有 Issue,通过正则匹配 `T\d{3,}` 标记识别已存在的任务,避免重复创建。最后,对于每个新任务,以 `T001: <描述>` 格式在对应的 GitHub 仓库中创建 Issue。此外,该技能支持通过 `.specify/extensions.yml` 配置文件注册的扩展钩子(hooks),在执行前后分别检查并执行可选或强制钩子,如自动提交或通知,从而与其他自动化工作流集成。该技能主要适用于使用 Specify 框架的开发者团队。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-taskstoissues

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

用户输入

$ARGUMENTS

在继续之前,你 必须 考虑用户输入(如果不为空)。

执行前检查

检查扩展钩子(在任务转议题之前):

  • 检查项目根目录下是否存在 .specify/extensions.yml。
  • 如果存在,读取它并查找 hooks.before_taskstoissues 键下的条目。
  • 如果 YAML 无法解析或无效,不要静默跳过:告知用户无法读取 .specify/extensions.yml(包括解析器错误),并且没有检查任何钩子,包括其中注册的强制(optional: false)钩子,然后正常继续。
  • 过滤掉 enabled 显式为 false 的钩子。没有 enabled 字段的钩子视为默认启用。
  • 对于每个剩余的钩子,不要尝试解释或评估钩子的 condition 表达式:
    • 如果钩子没有 condition 字段,或者该字段为 null/空,则将该钩子视为可执行。
    • 如果钩子定义了非空的 condition,则跳过该钩子,将条件评估留给 HookExecutor 实现。
  • 在从钩子命令名称构造命令调用时,将点号(.)替换为连字符(-)。例如,speckit.git.commit → /speckit-git-commit。
  • 对于每个可执行的钩子,根据其 optional 标志输出以下内容:
    • 可选钩子(optional: true):
      ## 扩展钩子
      
      **可选前置钩子**:{extension}
      命令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      执行:`/{command}`
      
    • 强制钩子(optional: false):
      ## 扩展钩子
      
      **自动前置钩子**:{extension}
      正在执行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      等待钩子命令的结果后再继续执行大纲。
      
      发出上述块之后,你 必须 实际调用该钩子并等待其完成,然后再继续。以你自己在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的文本 {command} id 不同,例如,技能模式代理将其运行为 /skill:speckit-... 或 $speckit-...)。仅发出块并不会运行钩子。
  • 如果没有注册钩子或 .specify/extensions.yml 不存在,则静默跳过。

大纲

  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. 如果存在:加载 .specify/memory/constitution.md 以获取项目原则和治理约束。
  3. 从已执行的脚本中,提取 tasks 的路径。
  4. 通过运行以下命令获取 Git 远程:
git config --get remote.origin.url

[!CAUTION] 仅当远程为 GitHub URL 时才继续执行后续步骤

  1. 获取现有 Issue 以进行去重:在创建任何内容之前,从 tasks.md 构建你将处理的 task ID 集合(每个 ID 是 T 后跟 至少 三位数字,例如 T001 — /speckit-converge 分配新 ID 的格式为 T{M+1:03d},这是一个下限而非上限,因此一旦文件中的任务超过 999 个,ID 将变为四位或更多位数字)。然后使用 GitHub MCP 服务器的 list_issues 工具查找已覆盖这些 ID 的 Issue。不要传递 state 值,因为省略它会使工具返回开放和关闭状态的 Issue。请求 perPage: 100 以减少调用次数,并且由于该工具使用基于游标的分页,请使用 after 参数(使用前一个响应的 endCursor)请求页面。对于每个 Issue 标题,将其与 task ID 模式 \bT\d{3,}\b 进行匹配({3,} 接受四位及以上的 ID — 使用 \d{3} 时,标题中包含 T1000 将根本无法匹配,因为尾部的 \b 不能落在两个数字之间,因此该任务将既不会被去重也不会被创建;词边界仍然会阻止像 ST001 这样的标记匹配,并且强制消耗整个数字序列,因此 T100 永远无法匹配 T1000 内的内容;这也能识别标题写作 T001 ...、T001: ... 或 [T001] ... 的情况),当它匹配到你的一个 task ID 时,将该 ID 标记为已有 Issue。一旦每个 task ID 都已被匹配,或者没有更多页面时,停止分页,这样一旦所有 task ID 都已处理完毕,你就不会继续获取整个仓库的 Issue 历史。这限制了在具有大量 Issue 历史记录的仓库上的调用次数,并且当命令在 tasks.md 重新生成或技能被再次调用后重新运行时,仍然可以防止重复。
  2. 对于列表中的每个任务,使用 GitHub MCP 服务器在代表 Git 远程的仓库中创建一个新的 Issue。tasks.md 中的任务行以 markdown 复选框开头,因此首先去掉前导的 - [ ](以及任何 [P] / [US#] 标记)以恢复 task ID 及其描述。使用 T001: <描述> 形式的单一规范标题创建 Issue,ID 只写一次,后跟任务描述(例如,行 - [ ] T001 创建项目结构 变为标题 T001: 创建项目结构)。
    • 跳过 任何其 ID 已存在于上一步现有 Issue 集合中的任务,并报告它(例如,T001 已有 Issue,跳过)。
    • 仅对尚未有匹配 Issue 的任务创建 Issue。

[!CAUTION] 在任何情况下都绝不要在不符合远程 URL 的仓库中创建 Issue

执行后检查

检查扩展钩子(在任务转议题之后): 检查项目根目录下是否存在 .specify/extensions.yml。

  • 如果存在,读取它并查找 hooks.after_taskstoissues 键下的条目。
  • 如果 YAML 无法解析或无效,不要静默跳过:告知用户无法读取 .specify/extensions.yml(包括解析器错误),并且没有检查任何钩子,包括其中注册的强制(optional: false)钩子,然后正常继续。
  • 过滤掉 enabled 显式为 false 的钩子。没有 enabled 字段的钩子视为默认启用。
  • 对于每个剩余的钩子,不要尝试解释或评估钩子的 condition 表达式:
    • 如果钩子没有 condition 字段,或者该字段为 null/空,则将该钩子视为可执行。
    • 如果钩子定义了非空的 condition,则跳过该钩子,将条件评估留给 HookExecutor 实现。
  • 在从钩子命令名称构造命令调用时,将点号(.)替换为连字符(-)。例如,speckit.git.commit → /speckit-git-commit。
  • 对于每个可执行的钩子,根据其 optional 标志输出以下内容:
    • 可选钩子(optional: true):
      ## 扩展钩子
      
      **可选钩子**:{extension}
      命令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      执行:`/{command}`
      
    • 强制钩子(optional: false):
      ## 扩展钩子
      
      **自动钩子**:{extension}
      正在执行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      发出上述块之后,你 必须 实际调用该钩子并等待其完成,然后再继续。以你自己在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的文本 {command} id 不同,例如,技能模式代理将其运行为 /skill:speckit-... 或 $speckit-...)。仅发出块并不会运行钩子。
  • 如果没有注册钩子或 .specify/extensions.yml 不存在,则静默跳过。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

相关技能