| name | workspace-manage |
| description | 回答 kata 能力/功能菜单/命令帮助类提问,或创建、初始化、自检、收尾、修复项目工作区。触发短语如「kata 能干嘛」「功能菜单」「初始化工作区」「自检/收尾工作区」。仅生成或编辑用例请转至 case-*;维护业务知识请转至 knowledge-curate;UI 自动化请转至 playwright-automation。 |
| argument-hint | <功能菜单 | init | 自检 | 收尾 | 修复> |
| user-invocable | true |
| model | sonnet |
| effort | medium |
workspace-manage
统一管理 kata 项目工作区,分两种模式:能力问答按命令索引直接回答、不碰工作区;工作区操作(创建 / 初始化 / 自检 / 收尾 / 修复)动手前先确认目录边界,确保产物落在约定位置。
路由边界
以下场景不属本 skill 范围,请转至对应 skill:
- 生成或编辑 QA 用例 → case-draft / case-edit
- 维护业务知识 → knowledge-curate
- UI 自动化 → playwright-automation
工作流
- 能力问答:问 kata 能干嘛、功能菜单、某命令怎么用——按命令索引直接回答,不改动工作区。
- 工作区操作:按下方命令流执行,动手前先确认目录边界(见「目录边界」),确保产物落在
workspace/{project}/ 之下。
工作区操作命令
flag 拼写以各命令 --help 为准。
- 自检 / 收尾:
kata init-wizard verify 输出环境检查状态表(Node、依赖、workspace、.env、插件、源码仓库);前 4 项全 pass 才算环境就绪,failed 项按 detail 里的提示修。
- 自检骨架:
kata create-project scan --project <name> 对比当前骨架与目标,输出缺失的目录 / 文件 / 配置注册情况;skeleton_complete 与 config_registered 都为 true 即完整。
- 创建 / 修复:先
kata create-project create --project <name> --dry-run 预览将创建什么,确认后改用 --confirmed 落盘;不带任一 flag 会拒绝执行并提示加 --confirmed。
目录边界
- 产物一律写入
workspace/{project}/ 之下,不外溢到仓库其它位置。
workspace/{project}/.kata/repos/** 是只读源仓库、也是事实来源:要改动须先取得用户明确确认,并在源仓库自己的工作区中操作,避免污染只读证据。