用途:在仓库首次采用 incu-way 时进行引导式初始化,为后续开发、缺陷与安全流程准备基础结构。它属于引导流程,不创建工作项状态文件 .ways/state.json。
主要能力:先做仓库资格检查(读取 ~/.ways/config.yaml 黑名单);Phase 0 只读探测仓库,判断是绿地、棕地还是已初始化,并识别技术栈、分支与已有 incu-way 结构;Gate 1 与用户确认模式与文档深度;随后建立分支隔离(当前检出分支或 .worktrees/ 下的独立 worktree);Phase 2 生成 CLAUDE.md、PRD.md、docs/(prds、bugs、security、architecture)与 .ways/,并维护 .gitignore;Phase 3 对棕地调用 incu-way-docs 生成架构/功能文档,绿地则记录预期架构;Gate 2 复核;Phase 4 通过 incu-way-prepare-pr 提交 PR 合并到 develop。
使用方式:按阶段执行,关键命令包括 git rev-parse、git branch -a、git switch develop、git worktree add .worktrees/incu-way-init -b chore/incu-way-init origin/develop 等;绿地无提交时需先征得同意再 git init 并创建空提交。
限制:每个 Gate 必须等待用户确认,不得自行提交或合并;无法推导的信息保留为 [TODO: ...],不得编造;不创建 .ways/state.json;不直接写入 develop 或 main。