用途:在项目最早期阶段进行深度上下文收集与工作流配置,生成 .planning/PROJECT.md(项目上下文)、.planning/config.json(工作流偏好)以及 .planning/intel/ 空脚手架(index.json、conventions.json、summary.md)。完成后需运行 /kata-add-milestone 定义首个里程碑。
主要能力与流程:
- 前置检查:若 .planning/PROJECT.md 已存在则中止并提示使用 /kata-track-progress;在当前目录初始化 git 仓库(git init -b main);检测已有代码(brownfield)。
- 已有代码处理:若检测到代码且无 .planning/codebase/,询问是否先运行 /kata-map-codebase 映射代码库,或跳过直接初始化。
- 深度提问:可选择直接描述项目或先运行 /kata-brainstorm 头脑风暴;随后以自由问答与追问方式澄清需求,直到可写出清晰的 PROJECT.md。
- 写入 PROJECT.md:创建 .planning/phases/pending、active、completed 目录及 .gitkeep,运行 node "scripts/scaffold-intel.cjs" 生成 intel 脚手架,按模板合成内容并提交 git。
- 工作流偏好:询问模式(YOLO/Interactive)、规划深度(Quick/Standard/Comprehensive)、模型质量(Balanced/Quality/Budget)、是否提交规划文档、是否使用 PR 工作流、是否启用 GitHub Milestone/Issue 跟踪;PR 工作流下追问是否使用 git worktrees;GitHub 跟踪下追问 Issue 创建时机(Auto/Ask per milestone/Never),并检查 gh 认证与远程仓库,必要时用 gh repo create --source=. --private --push 创建。
- 生成 config.json 并提交;若启用 worktrees,运行 bash "scripts/setup-worktrees.sh",失败时按错误提示修复并重试,仍失败则回退 worktree.enabled 为 false;成功后 cd main。PR 工作流下可询问是否生成 .github/workflows/release.yml,并建议开启分支保护。
适用场景:新项目启动、已有代码库的规划初始化、需要统一工作流与 GitHub 跟踪配置的团队。
限制:依赖 git、gh CLI 与 Node 脚本;部分行为(如 worktrees、GitHub 集成)需满足前置条件;具体模型与成本细节资料未提供。