SuperAPI AI 工具集

kata-doctor

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

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

主要能力:

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

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

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

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