| name | aibdd-auto-starter |
| description | 從 arguments.yml 與 templates 產生 walking skeleton；以 STARTER_VARIANT 分流 frontend / backend。支援 python-e2e（FastAPI + Behave）、java-e2e（Spring Boot 4 + Cucumber）、nextjs-storybook-cucumber-e2e（Next.js 16 + Storybook 10 + playwright-bdd）。TRIGGER when 使用者說初始化前/後端、建前/後端骨架、frontend/backend starter、walking skeleton，或被 kickoff 後續流程委派。SKIP when 需求是 feature-specific 業務頁面/元件/API client/model/service/API/step definition 實作或既有專案重構。 |
| metadata | {"user-invocable":true,"source":"project-level dogfooding","skill-type":"utility"} |
aibdd-auto-starter
Generate a walking skeleton from kickoff arguments and starter templates. The variant set covers both backend (python-e2e / java-e2e) and frontend (nextjs-storybook-cucumber-e2e); dispatch is driven entirely by STARTER_VARIANT in arguments.yml.
§1 REFERENCES
| ID | Path | Phase scope | Purpose |
|---|
| R1 | references/variants/python-e2e.md | global | 定義 Python E2E backend starter（FastAPI + Behave + Alembic + Testcontainers）的 stack、placeholder、驗證與安全邊界 |
| R2 | references/variants/java-e2e.md | global | 定義 Java E2E backend starter（Spring Boot 4 + Cucumber + Flyway + Testcontainers + JdbcClient）的 stack、placeholder、驗證與安全邊界 |
| R3 | references/variants/nextjs-storybook-cucumber-e2e.md | global | 定義 Next.js 16 + React 19 + TypeScript 5 + Tailwind 4 + Storybook 10 + Playwright + playwright-bdd + Vitest 4 frontend starter 的 stack、placeholder、驗證與安全邊界 |
§2 SOP
依序執行 Phase 1–6，不在中途停下徵詢「要不要繼續」；唯一需要與使用者互動的地方是 Phase 3 詢問專案目錄／名稱（且僅在 caller 未提供時）。任一 Phase 標明「停止」即終止整個 skill、不再往下。
Phase 1 — 取得 caller context 與 arguments.yml
- 確認本 skill 目錄與當前工作目錄（cwd）。
- 若 caller 傳入 payload 就讀取它。arguments.yml 的位置：payload 內帶
arguments_path → 用它（解析為絕對路徑）；否則預設 ${cwd}/.aibdd/arguments.yml。
- 確認 arguments.yml 是否存在。不存在 → 回報「
arguments.yml 不存在；請先執行 /aibdd-kickoff 並選擇對應的 starter 變體」並停止。
Phase 2 — 解析 starter 變體
- 讀取並解析 arguments.yml（YAML）。
- 取
STARTER_VARIANT 決定變體：
- 為
python-e2e / java-e2e / nextjs-storybook-cucumber-e2e 之一 → 採用。
- 缺少
STARTER_VARIANT → 嘗試由既有鍵推測（出現 PY_ 前綴 → python-e2e；含 BASE_PACKAGE 或 GROUP_ID 鍵 → java-e2e）。仍無法判定 → 回報「arguments.yml 缺少 STARTER_VARIANT；請填 STARTER_VARIANT: python-e2e / java-e2e / nextjs-storybook-cucumber-e2e，或重新執行 /aibdd-kickoff」並停止。
- 其他不支援的值 → 回報「目前 starter 支援
python-e2e / java-e2e / nextjs-storybook-cucumber-e2e；其他 variant 尚未實作。請改填其中之一，或重新執行 /aibdd-kickoff。」並停止。
- 依變體決定
variant_kind：python-e2e / java-e2e → backend；nextjs-storybook-cucumber-e2e → frontend。
- 讀取對應的 variant 契約
references/variants/<variant>.md。
- 確認 starter templates 目錄
templates/<variant> 存在。不存在 → 回報「starter templates 不存在：<templates 路徑>」並停止。
Phase 3 — 收集專案輸入
- 決定專案目錄
project_dir：caller payload 有提供 → 用它（解析為絕對路徑）；否則詢問使用者「專案要建立在哪個目錄？預設為目前工作目錄。」
- 決定專案名稱
project_name：caller payload 有提供 → 用它；否則詢問使用者「專案名稱？用於專案配置檔（pyproject.toml / pom.xml / package.json）與容器／scenario 命名。」
- 驗證：
project_dir 必須是絕對路徑、project_name 長度大於 0；任一不成立即停止。
- 確認 arguments.yml 與專案同 repo：
arguments.yml 路徑（正規化後）須等於 ${project_dir}/${AIBDD_ARGUMENTS_PATH}。不一致 → 回報「starter 只讀同 repo 內既有 AIBDD project config；請在已 kickoff 的 <backend|frontend> root（依 variant_kind）執行，且 arguments.yml 必須位於 ${project_dir}/${AIBDD_ARGUMENTS_PATH}。若 layout 不對，請重跑 /aibdd-kickoff 並選擇正確的根目錄。」並停止。
Phase 4 — 產生 skeleton
- 執行
uv run ${skill_dir}/scripts/generate-skeleton.py --project-dir "${project_dir}" --project-name "${project_name}" --variant "${variant}" --arguments "${arguments_path}"。
- 退出碼非 0 → 回報 generator 失敗摘要並停止。
- 從輸出解析本次寫入的檔案數。
- 若輸出含
SKIP (exists) → 告知使用者「部分檔案已存在，generator 已依安全規則跳過覆蓋。」
Phase 5 — 驗證 starter 健康
- 依 variant 契約取得該 variant 的 dry-run 指令，在
project_dir 下執行。
- 退出碼非 0 → 回報 dry-run 失敗摘要並停止。
Phase 6 — 回報
- 整理結果回報給 caller，含：
status: completed、variant、variant_kind、files_written、project_dir、specs_location（= ${project_dir}/${SPECS_ROOT_DIR}）、dry_run_passed。
- 依 variant 契約的「完成後引導」section 取得 post-install／下一步指令提示。
- 給使用者白話摘要，並提醒：下游
/aibdd-flows-specify 必須以 project_dir 為工作目錄（cwd），使 AIBDD_ARGUMENTS_PATH / BDD_CONSTITUTION_PATH（bdd-stack 目錄錨點）/ DEV_CONSTITUTION_PATH 相對路徑與 .aibdd/arguments.yml 同框解析；starter 不產生、不改寫 specs/。一併附上對應 variant 的 dependency install / dev-server 指令提示。
§3 CROSS-REFERENCES
/aibdd-kickoff — 上游產生 arguments.yml 與專案邊界設定（含 STARTER_VARIANT）/aibdd-flows-specify — walking skeleton 完成後的下一個規劃系統流程入口/aibdd-auto-frontend-msw-api-layer — frontend variant 後續以 OpenAPI 生成 MSW handlers + API client（Stage 1）/aibdd-auto-frontend-nextjs-pages — frontend variant 後續逐 frame 落 Next.js 動態頁面（Stage 2）
