SuperAPI AI 工具集

implement-and-validate

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:在编码任务中端到端实现“一个”指定任务,从实现、自审、校验到提交,并返回报告。

主要能力与约束:按任务规格精确实现,不添加额外功能、重构或超出范围的改进,遵循现有代码模式与约定;实现方法依赖 codagent:implement-with-tdd 技能;实现后做结构化自审,检查任务场景是否全部实现、是否存在规格未支持的改动、成功标准是否满足、测试与 linter 是否通过,发现问题先修复再进入校验。

使用方式:自审通过后直接运行校验器(不要调用 agent-validator:validator-run 技能)。先清理陈旧锁:mkdir -p validator_logs 与 rm -f validator_logs/.validator-run.lock;再运行 agent-validator run > validator_logs/_subagent-run.log 2>&1; printf 'VALIDATOR_EXIT=%s\n' "$?" >> validator_logs/_subagent-run.log,Bash 超时设为 300000(5 分钟),不要用 run_in_background;随后用 cat validator_logs/_subagent-run.log 读取输出。退出码 1 表示发现违规而非基础设施故障,不应盲目重试。根据 Status 行处理:Passed 或 Passed with warnings 则提交;Failed 需按输出修复 CHECK 或 REVIEW 违规后重跑,最多重试 3 次;Retry limit exceeded 则停止并记录;无 Status 行时读取最新 console 日志 ls -t validator_logs/console.*.log 2>/dev/null | head -1 | xargs -r cat,若也没有则再跑一次。校验通过后提交:有 commit-commands:commit 技能则调用,否则暂存全部改动并按 <type>: <description> 格式提交 git commit -m "<message>"。

适用场景:需要可追溯、带校验关卡的单任务自动实现流程。限制:遇到缺依赖、环境损坏或需求矛盾等真实阻塞时立即返回失败并说明尝试内容、阻塞原因与无法推进的原因,不等待输入;报告格式与超时参数属资料明确要求,缺失的收费、平台等信息暂未提供。