SuperAPI AI 工具集

agentic-validators

智能体与模型

查看项目

更新于 10-16 04:31

技能介绍

用途:把“智能体写了代码”转化为“智能体写了代码且改动被自动验证”。该技能帮助选择验证策略(按文件还是全仓库)、实现 post-tool-use 与 stop 钩子、创建窄而快速的确定性检查,并让多个智能体并行工作时保持正确性。

核心理念:智能体是非确定性的,验证器是确定性的;上下文易失,验证与日志持久。优先使用贴近改动的小而快的检查(按文件),再加一道全局终检(全仓库)。

钩子选择:post-tool-use 钩子为默认推荐,适合编辑后立即反馈、只验证被触碰的文件、不想跑全量测试时;典型检查含格式化(prettier/black)、lint(eslint/ruff)、对单个文件或模块做类型检查(tsc --noEmit 配项目配置)。stop 钩子为运行结束时的门禁,适合需要全仓库不变量与最后“退出标准”检查,典型检查含单元测试、构建、集成测试。

落地步骤:识别文件类型与快速检查(JS/TS 用 prettier+eslint+typecheck,Python 用 ruff 及可选的 pytest,Go 用 gofmt 及可选的 go test);实现按文件验证器,要求快(约 5–30 秒)、确定性、输出清晰、可重复运行;接入钩子,post-tool-use 钩子调用验证器并传入文件路径;写日志到固定位置(如 .agent-logs/validators.log);新增 stop 钩子作为最终门禁跑更广的检查。

验证模式示例:模式 A“格式化+lint 被触碰文件”,若格式化器产生改动则失败并要求智能体提交格式化结果后重跑;模式 B 对触碰模块跑聚焦的单元测试子集;模式 C 文档改动时跑 markdown lint 与链接检查。并行模式:对大量同类文件(CSV、配置、文档)每文件派生子智能体,各自跑 post-tool-use 验证器,聚合智能体只接受验证通过的结果。

常见失败与修复:验证器太慢则拆成快速按文件检查加较慢 stop 钩子;验证不稳定则去掉网络调用、固定版本、仅在安全处加重试;智能体忽略工具文档则写简短“基本约定”并指向参考文件。

限制:资料未提供具体安装命令、代码示例全文、收费与平台支持信息。