用户输入
$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不存在,则静默跳过。
大纲
- 从仓库根目录运行
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks,并解析 FEATURE_DIR 和 AVAILABLE_DOCS 列表。所有路径必须是绝对路径。对于参数中的单引号,例如 "I'm Groot",请使用转义语法:例如 'I'''m Groot'(或者如果可能的话使用双引号:"I'm Groot")。 - 如果存在:加载
.specify/memory/constitution.md以获取项目原则和治理约束。 - 从已执行的脚本中,提取 tasks 的路径。
- 通过运行以下命令获取 Git 远程:
git config --get remote.origin.url
[!CAUTION] 仅当远程为 GitHub URL 时才继续执行后续步骤
- 获取现有 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重新生成或技能被再次调用后重新运行时,仍然可以防止重复。 - 对于列表中的每个任务,使用 GitHub MCP 服务器在代表 Git 远程的仓库中创建一个新的 Issue。
tasks.md中的任务行以 markdown 复选框开头,因此首先去掉前导的- [ ](以及任何[P]/[US#]标记)以恢复 task ID 及其描述。使用T001: <描述>形式的单一规范标题创建 Issue,ID 只写一次,后跟任务描述(例如,行- [ ] T001 创建项目结构变为标题T001: 创建项目结构)。- 跳过 任何其 ID 已存在于上一步现有 Issue 集合中的任务,并报告它(例如,
T001 已有 Issue,跳过)。 - 仅对尚未有匹配 Issue 的任务创建 Issue。
- 跳过 任何其 ID 已存在于上一步现有 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不存在,则静默跳过。