SuperAPI AI 工具集

spec-init

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

用途:在本仓库的 AI SDLC 流程中初始化需求级 Spec Pack,适用于尚未创建 {num}-{short-name} 分支与 .aisdlc/specs/... 目录的新需求;已存在完整 Spec Pack 时不再使用。

主要能力:自动递增三位编号;创建并切换到 {num}-{short-name} 分支(short-name 为 2-4 词 kebab-case,保留 oauth2、jwt、api 等缩写);生成 .aisdlc/specs/{num}-{short-name}/,含 requirements/、design/、implementation/、verification/、release/ 五个子目录;把原始需求写入 requirements/raw.md(UTF-8 with BOM)。即使仓库含 .gitmodules,也只初始化根项目,不批量创建子仓分支。

用法:需求内容一律以文件路径传入。输入为文件路径时直接作为 sourceFilePath;输入为文本时先用 Write 工具写入仓库根目录临时文件 _sdlc-raw-temp.md 再传该路径。脚本位于 <SKILL.md 目录>/scripts/,按系统选择:PowerShell 用 powershell -NoProfile -ExecutionPolicy Bypass -File ".../spec-create-branch.ps1" -ShortName "<kebab-case>" -SourceFilePath "<需求文件路径>" [-Title "<标题>"];Bash 用 spec-create-branch.sh --short-name <...> --source-file <...> [--title <...>]。脚本执行成功后会删除传入的源文件,需保留应先备份。

验收:当前分支符合 {num}-{short-name};.aisdlc/specs/<branchName>/ 含五个必需子目录;raw.md 内容等于原始需求;源文件已删除。

限制:不以 spec/、feature/ 等自创结构命名;不把中文需求直接作命令行参数;不把 submodule 当 Spec 根目录;完成后需输出 ROUTER_SUMMARY 并调用 using-aisdlc 路由下一步。