SuperAPI AI 工具集

kata-doctor

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:对 Kata 项目执行健康检查,检测并修复项目结构中的格式问题。触发词包括 doctor、health check、fix roadmap、check project 等。

主要能力:

  1. Roadmap 格式迁移:检测旧格式的 .planning/ROADMAP.md 并迁移到当前格式。通过 node scripts/kata-lib.cjs check-roadmap 检测,退出码 0 表示当前格式、1 表示旧格式需迁移、2 表示未找到文件。迁移步骤包括解析旧格式、识别里程碑边界、构建当前格式结构、写入并验证,最后按配置提交。
  2. 阶段目录冲突检测:扫描 active、pending、completed 各状态目录及扁平目录中重复的数字前缀。发现冲突时,交互模式下执行两遍重命名(先改为临时名,再改为全局顺序编号),并更新 ROADMAP.md 与 STATE.md,保留历史 details 块不变。

使用方式:用户直接调用时以交互模式运行,带确认提示;被其他技能调用(自动模式,--auto)时,格式迁移自动进行,冲突修复仅报告问题并建议交互运行 /kata-doctor。提交受 commit_docs 配置控制,若 .planning 被 git 忽略则不提交。

适用场景:Kata 项目结构维护、旧项目升级、阶段编号整理。

限制:冲突修复在自动模式下不会执行;不修改历史 details 块内容;不在冲突修复时重命名已完成阶段的内部文件;单项检查失败不影响整体健康检查。具体安装方式与依赖暂未提供。