用途:配置 kata 会话设置与工作流变体,触发词包括 settings、configure、preferences、workflow config、workflow variants。
主要能力:先校验环境,若 .planning/config.json 不存在则提示先运行 /kata-new-project。通过访问脚本读取当前值,例如 node scripts/kata-lib.cjs read-pref "mode" "yolo",涵盖 mode、depth、model_profile、commit_docs、pr_workflow、workflow.research、workflow.plan_check、workflow.verifier、worktree.enabled,以及 workflows.execute-phase 的 post_task_command、commit_style、commit_scope_format,workflows.verify-work.extra_verification_commands,workflows.complete-milestone.version_files 与 pre_release_commands。
使用方式:分两段展示设置(会话设置、工作流变体),用 AskUserQuestion 预选当前值供用户确认;文本项显示当前值并询问是否修改。写入通过 node scripts/kata-lib.cjs set-config "键" "$新值" 完成。
副作用:若刚启用 worktree,需先提交配置改动再运行 bash scripts/setup-worktrees.sh,失败则回退 worktree.enabled 为 false;成功后提示从 main/ 重启 Claude Code。若禁用 worktree,则提示计划将在共享目录执行。若 commit_docs 改为 false,则把 .planning/ 加入 .gitignore,并提示已跟踪时运行 git rm -r --cached .planning/。
适用场景:调整 kata 规划与执行阶段的行为、模型成本档位、PR 与 worktree 流程。限制:设置仅对后续 /kata-plan-phase 与 /kata-execute-phase 生效;worktree 依赖 PR 工作流,pr_workflow 为 false 时不显示该问题。