用途:在 AI DLC 流程中为“新需求”初始化 Spec Pack。已存在合法 spec 分支且目录完整时不适用。
主要能力:递增三位编号;创建并切换 {num}-{short-name} 分支(short-name 为 kebab-case,小写字母/数字/连字符,2-4 词);生成 .aidlc/specs/{num}-{short-name}/,含 requirements/、design/、implementation/、verification/、release/ 五个子目录;把原始需求写入 requirements/raw.md(UTF-8 with BOM)。
使用方式:先把需求落到文件路径。输入是文件则直接作为源路径并提示将被删除;是文本则用 Write 写入仓库根目录 _dlc-raw-temp.md 再传路径。脚本在 <本SKILL.md目录>/scripts/ 下按系统选择:Windows/PowerShell 用 powershell -NoProfile -ExecutionPolicy Bypass -File "<脚本路径>" -ShortName "<kebab-case>" -SourceFilePath "<需求文件路径>" [-Title "<标题>"](需 PowerShell 5.0+);macOS/Linux 执行 spec-create-branch.sh --short-name <...> --source-file <...> [--title <...>],stdout 输出 JSON。
验收(DoD):当前分支符合 {num}-{short-name};.aidlc/specs/<branchName>/ 含五个子目录;requirements/raw.md 存在且内容等于原始需求;传入源文件已被删除(需保留应提前备份)。完成后输出 ROUTER_SUMMARY 并立即调用 using-aidlc 路由下一步。
限制:脚本成功后删除源文件;仅初始化根项目,不在本阶段创建 submodule 分支;若仓库含 .gitmodules 时子仓分支由后续 I1/I2 门禁处理;禁止使用 spec/、feature/ 等自创命名,不要把中文需求直接当命令行参数。其他收费、平台等资料暂未提供。