用途:在项目最早期阶段进行深度上下文收集与工作流配置,生成 .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 脚手架;按模板合成需求(greenfield 为假设,brownfield 从代码推断已验证项)、关键决策表并提交。
- 工作流偏好:询问模式(YOLO/Interactive)、深度(Quick/Standard/Comprehensive)、模型质量(Balanced/Quality/Budget)、是否提交规划文档、是否使用 PR 工作流、是否启用 GitHub 跟踪;条件性追问 worktree 与 Issue 创建方式,并生成 config.json。
- 可选集成:若启用 GitHub 跟踪,检查 gh 认证与远程仓库,可执行 gh repo create --source=. --private --push 或 --public --push;若启用 worktree,运行 bash "scripts/setup-worktrees.sh" 并 cd main;若启用 PR 工作流,可脚手架 .github/workflows/release.yml 并建议开启分支保护。
限制:资料未提供该技能的收费、价格、平台支持范围与效果保证;部分脚本(如 scaffold-intel.cjs、setup-worktrees.sh、kata-lib.cjs)需在对应仓库环境中存在,失败时按提示修复或回退。