用途:pre-ship 用于在开发者或 AI 智能体准备宣称“工作已完成、缺陷已修复、测试已通过”之前,强制执行验证流程。其核心理念是“先有证据,再下结论”,没有在本条消息中实际运行过的验证命令,就不得声称它通过。
主要能力:该技能提供一套声明前的关卡流程:识别哪条命令可以证明结论;完整、重新地运行该命令;读取完整输出、检查退出码并统计失败数;确认输出是否支持结论;只有证据充分时才作出声明。它同时列出了一系列常见的虚报场景:测试通过需要测试命令输出为 0 失败,而此前运行结果或“应该能通过”不算证据;linter 干净需要 linter 输出 0 错误,部分检查或外推不算;构建成功需要构建命令退出码 0,linter 通过并不等于编译通过;缺陷修复需要通过原始症状的测试;回归测试需要验证红绿循环;智能体完成任务需要查看版本控制差异。
使用方式:在任何完成、成功或满意的表述之前套用该流程,包括提交代码、创建 PR、结束任务、进入下一项任务或向下级智能体委派任务时。输出时需附上实际运行的命令、看到的输出和退出码等证据。文档给出的口令是“运行命令,读取输出,然后再声明结果”。
适用场景:面向编码任务的收尾阶段,尤其适合使用 AI 智能体协助开发、需要频繁确认测试与构建状态的团队或个人。文档也给出了触发停止的信号,如使用“应该”“大概”“看起来”,或在验证前就表示满意、信任智能体的成功报告、依赖部分验证等。
限制:资料未提供该技能的安装与配置方式、支持的运行环境、版本信息及收费情况;其内容主要为流程与纪律规范,具体命令需按项目自身的测试、构建和 lint 工具决定。