SuperAPI AI 工具集

finalize

通用与其它

查看项目

更新于 10-16 03:38

技能介绍

用途:finalize 是一个实现后置的质量保证工作流技能,适合在功能开发或改动完成后、准备交付前使用。它把打磨代码、精简文档、更新变更日志、自我改进与提交发布串成固定流程。

主要能力与流程:开始时用 TaskCreate 为每个阶段建立任务。阶段1运行 /polish-code 处理当前改动;阶段2对暂存改动(git diff --cached)运行 /simplify-docs,并暂存其产生的编辑;阶段3运行 /update-changelog,同样暂存编辑;阶段4运行 /self-improve,即使会话看似平常也必须执行;阶段5进入交付。

交付阶段先做拆分分析:用 git diff --cached --stat 和 git diff --cached 了解范围,按关注类型(重构、缺陷修复、新功能、清理、依赖更新)、层级/领域(后端、前端、数据库迁移、i18n、测试、配置)和逻辑单元三个维度归类,判断暂存改动是一个可评审单元还是多个。若为单一内聚单元,直接运行 /ship;若跨多个可评审单元,则提出有序分组(名称、一句话描述、文件列表、依赖关系),用 AskUserQuestion 让用户选择一起交付(/ship)或拆分交付(/split-and-ship),随后用 TaskList 处理剩余任务。

限制与规则:不得因改动大小、文件数量、测试通过、紧迫感或上下文窗口等理由跳过任何阶段;不得以会话过长或前序阶段已充分为由跳过。禁止暂存或提交包含密钥的文件(.env、凭据、API 密钥),发现时要警告。不向用户展示 diff(用户使用外部 git 客户端评审),仅在内部按需使用。若 polish、review 等非测试步骤失败,应停止并报告,不得跳过继续。原文未提供具体安装命令与配置方式。