SuperAPI AI 工具集

kata-complete-milestone

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在里程碑完成时创建已发布版本的历史记录,归档里程碑产物(路线图与需求),并准备下一个里程碑。输出包括:里程碑归档(路线图与需求)、PROJECT.md 演进、Git 打标签。

主要能力:按 milestone-complete.md 工作流执行;先检查 pr_workflow 配置,若为 true 且位于 main 分支,则创建 release/vX.Y.Z 发布分支;检查并自动迁移旧版 ROADMAP.md 格式(必要时调用 kata-doctor --auto);读取 workflows.complete-milestone 的 version_files 与 pre_release_commands 覆盖配置;依据 version-detector.md 与 changelog-generator.md 生成变更日志与版本号(按提交前缀判断 major/minor/patch),更新项目版本文件;检查 .planning/v{{version}}-MILESTONE-AUDIT.md 审计状态;验证各阶段均有 SUMMARY.md;统计阶段、计划、任务、代码行与时间线;提取 4-6 项关键成果;归档路线图与需求到 .planning/milestones/,删除 .planning/REQUIREMENTS.md,更新 PROJECT.md;可选最终 README 审查;关闭 GitHub Milestone;提交 chore: complete v{{version}} milestone;按 PR 工作流推送分支并创建 PR,或本地打标签;提供发布后验证任务菜单(冒烟测试、产物校验、CI/CD 状态)。

使用方式:作为技能调用,需提供 Version(如 "1.0"、"1.1"、"2.0")。关键命令保持原样,例如:git checkout -b "$RELEASE_BRANCH"、node scripts/kata-lib.cjs read-config "pr_workflow" "false"、git tag -a v{{version}} -m "[milestone summary]"、gh pr create --head "$CURRENT_BRANCH" --base main。

适用场景:标记里程碑完成、发布版本、收尾里程碑工作、为下一版本做准备。

限制:依赖 kata-skills 的脚本与参考文件(kata-lib.cjs、milestone-complete.md 等);需 Git 环境,GitHub 相关步骤需 gh CLI 与相应配置;审计缺失或存在缺口时会给出警告,可继续但视为技术债;具体收费、平台支持等信息暂未提供。