spec-init

概览

spec-init 用于在本仓库里创建一个新的需求级 Spec Pack：自动递增三位编号、创建并切换到 {num}-{short-name} 分支、生成 .aisdlc/specs/{num}-{short-name}/ 目录结构，并把原始需求写入 requirements/raw.md（UTF-8 with BOM）。

约束：即使仓库包含 .gitmodules，spec-init 也只初始化根项目的 Spec 分支与 Spec Pack；子仓分支不在本阶段批量创建。

何时使用 / 不使用

• 使用时机
  • 用户要开始一个"新需求"的 Spec（还没有 {num}-{short-name} 分支与 .aisdlc/specs/... 目录）。
  • 用户只给了中文需求文本（不方便先手动建文件），担心参数编码导致乱码。
  • 需要确保分支命名、编号来源、目录结构符合仓库约定。
• 不要用在
  • 已经在一个合法的 {num}-{short-name} spec 分支上，且 .aisdlc/specs/{num}-{short-name}/ 已存在并结构完整（这时直接进入后续命令）。

快速参考