用途:确保代码库交付物在任务标记完成前被正确归档为 ZIP 文件。该技能规定,仅创建项目目录和文件不等于任务完成,未通过 ZIP 验证前任务完成被阻止。
主要能力:提供强制性的完成前检查清单,包括确认项目目录存在、关键文件(如 package.json、README.md、源码)齐全、执行压缩命令、验证 ZIP 存在且大小大于 0 字节,并可选检查内容。还包含迭代感知的预警机制:当迭代次数达到上限的 80%(如 30 次中的第 25 次)时,立即停止非必要代码生成,执行最小可行 ZIP 回退,将现有文件打包,并在完成摘要中记录回退原因。
使用方式:正常流程下,先确认项目完整性,再执行 zip -r <output_filename>.zip <project_directory>/,例如 zip -r project.zip ./project;随后用 ls -lh <output_filename>.zip 验证,可选 unzip -l <output_filename>.zip 检查内容。回退命令为 zip -r project_fallback.zip ./project/ 2>/dev/null || zip -r project_fallback.zip ./*,并验证 ls -lh project_fallback.zip。ZIP 命令必须作为声明完成前的最后一步执行。
适用场景:需要交付单一可下载 ZIP 产物的编码任务,尤其是迭代次数受限、可能耗尽预算的环境。
限制与注意事项:需确保执行环境中有 zip 工具,否则需安装或改用 tar 等替代方案;注意隐藏文件(如 .env、.gitignore)可能需要显式包含;避免打包父目录或错误路径;不得在未创建并验证 ZIP 的情况下声明完成,否则视为任务失败。资料未提供具体安装命令、收费或平台信息。