plan

用户输入

$ARGUMENTS

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

执行前检查

检查扩展钩子(规划前):

• 检查项目根目录是否存在 .specify/extensions.yml 文件。
• 如果存在, 读取该文件并查找 hooks.before_plan 键下的条目
• 如果 YAML 无法解析或无效, 静默跳过钩子检查并正常继续
• 过滤掉 enabled 显式为 false 的钩子。将没有 enabled 字段的钩子视为默认启用。
• 对于每个剩余的钩子, 不要尝试解释或评估钩子的 condition 表达式:
  • 如果钩子没有 condition 字段, 或者为 null/空, 则将钩子视为可执行
  • 如果钩子定义了非空的 condition, 则跳过该钩子并将条件评估留给 HookExecutor 实现
• 对于每个可执行的钩子, 根据其 optional 标志输出以下内容:
  • 可选钩子 (optional: true):

    ## 扩展钩子
    
    **可选前置钩子**: {extension}
    命令: `/{command}`
    描述: {description}
    
    提示: {prompt}
    执行方式: `/{command}`
    

  • 必需钩子 (optional: false):

    ## 扩展钩子
    
    **自动前置钩子**: {extension}
    正在执行: `/{command}`
    EXECUTE_COMMAND: {command}
    
    等待钩子命令的结果后再继续执行大纲。
    

• 如果没有注册钩子或 .specify/extensions.yml 不存在, 静默跳过

大纲

1. 设置: 从仓库根目录运行 {SCRIPT} 并解析 JSON 获取 FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH。对于参数中的单引号如 "I'm Groot", 使用转义语法: 例如 'I'''m Groot' (或尽可能使用双引号: "I'm Groot")。

2. 加载上下文: 读取 FEATURE_SPEC 和 /memory/constitution.md。加载 IMPL_PLAN 模板(已复制)。

3. 执行规划工作流: 按照 IMPL_PLAN 模板中的结构:

   • 填写技术上下文(将未知项标记为 "NEEDS CLARIFICATION")
   • 从章程填写章程检查部分
   • 评估门控条件(如果违规且无正当理由则报 ERROR)
   • 阶段 0: 生成 research.md(解决所有 NEEDS CLARIFICATION)
   • 阶段 1: 生成 data-model.md, contracts/, quickstart.md
   • 阶段 1: 通过运行代理脚本更新代理上下文
   • 设计后重新评估章程检查

4. 停止并报告: 命令在阶段 2 规划后结束。报告分支, IMPL_PLAN 路径和生成的制品。

5. 检查扩展钩子: 报告后, 检查项目根目录是否存在 .specify/extensions.yml 文件。

   • 如果存在, 读取该文件并查找 hooks.after_plan 键下的条目
   • 如果 YAML 无法解析或无效, 静默跳过钩子检查并正常继续
   • 过滤掉 enabled 显式为 false 的钩子。将没有 enabled 字段的钩子视为默认启用。
   • 对于每个剩余的钩子, 不要尝试解释或评估钩子的 condition 表达式:
     • 如果钩子没有 condition 字段, 或者为 null/空, 则将钩子视为可执行
     • 如果钩子定义了非空的 condition, 则跳过该钩子并将条件评估留给 HookExecutor 实现
   • 对于每个可执行的钩子, 根据其 optional 标志输出以下内容:
     • 可选钩子 (optional: true):

       ## 扩展钩子
       
       **可选钩子**: {extension}
       命令: `/{command}`
       描述: {description}
       
       提示: {prompt}
       执行方式: `/{command}`
       

     • 必需钩子 (optional: false):

       ## 扩展钩子
       
       **自动钩子**: {extension}
       正在执行: `/{command}`
       EXECUTE_COMMAND: {command}
       

   • 如果没有注册钩子或 .specify/extensions.yml 不存在, 静默跳过