specify

用户输入

$ARGUMENTS

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

执行前检查

检查扩展钩子(规范创建前):

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

    ## 扩展钩子
    
    **Optional Pre-Hook**: {extension}
    Command: `/{command}`
    Description: {description}
    
    Prompt: {prompt}
    To execute: `/{command}`
    

  • 强制钩子 (optional: false):

    ## 扩展钩子
    
    **Automatic Pre-Hook**: {extension}
    Executing: `/{command}`
    EXECUTE_COMMAND: {command}
    
    Wait for the result of the hook command before proceeding to the Outline.
    

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

大纲

用户在触发消息中 /speckit.specify 之后输入的文本就是功能描述。假设你在这个对话中始终可以获取到它, 即使下面 {ARGS} 字面上显示为空。除非用户提供了空命令, 否则不要要求用户重复输入。

根据该功能描述, 执行以下操作:

1. 生成简洁的短名称(2-4 个单词)用于分支:

   • 分析功能描述并提取最有意义的关键词
   • 创建一个能捕捉功能本质的 2-4 个单词的短名称
   • 尽可能使用动名词格式(例如 "add-user-auth", "fix-payment-bug")
   • 保留技术术语和缩写(OAuth2, API, JWT 等)
   • 保持简洁但足够描述性, 以便一眼就能理解功能
   • 示例:
     • "I want to add user authentication" → "user-auth"
     • "Implement OAuth2 integration for the API" → "oauth2-api-integration"
     • "Create a dashboard for analytics" → "analytics-dashboard"
     • "Fix payment processing timeout bug" → "fix-payment-timeout"

2. 创建功能分支, 通过运行带有 --short-name(和 --json)的脚本来创建。在顺序模式下, 不要传递 --number — 脚本会自动检测下一个可用编号。在时间戳模式下, 脚本会自动生成 YYYYMMDD-HHMMSS 前缀:

   分支编号模式: 在运行脚本之前, 检查 .specify/init-options.json 是否存在并读取 branch_numbering 值。

   • 如果是 "timestamp", 在脚本调用中添加 --timestamp(Bash)或 -Timestamp(PowerShell)

   • 如果是 "sequential" 或不存在, 不添加任何额外标志(默认行为)

   • Bash 示例: {SCRIPT} --json --short-name "user-auth" "Add user authentication"

   • Bash(时间戳): {SCRIPT} --json --timestamp --short-name "user-auth" "Add user authentication"

   • PowerShell 示例: {SCRIPT} -Json -ShortName "user-auth" "Add user authentication"

   • PowerShell(时间戳): {SCRIPT} -Json -Timestamp -ShortName "user-auth" "Add user authentication"