SuperAPI AI 工具集

amplifier-agent-bugfix

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:系统化地分诊并修复 amplifier-agent 的缺陷,从报告一路走到经过验证的修复。核心原则是:缺陷是被违反或描述不足的契约,修复等于可用代码加上能阻止同类问题再次静默出现的覆盖;根因未锁定前不改代码,测试与评分标准不得为了让修复通过而修改。

主要能力与流程:按阶段顺序推进,使用 todo 工具跟踪,并在提交与发布前停止。阶段 0 收集失败代码、脚本或 HTTP 请求及其原始输出、接口面(Python、TypeScript 或 HTTP)、提供方与模型、安装方式、操作系统与运行时版本、是否必现;若输出质量变差则按质量回归处理。阶段 1 排除环境漂移、过期的 TS 构建、过期的 face 进程、装错代码、上游失败、模型变更等廉价原因,并在干净环境复现。阶段 2 在不改源码的前提下提出至多两个指向不同修复的假设,并给出判定规则,通过开关、接口面 A/B、安装 A/B、脚本化提供方、diff 等方式逐一验证。阶段 3 阅读 contracts/*.v1.md 与对应 docs/<binding>/reference.md,判断代码违约、文档不一致、契约沉默或行为即契约。阶段 4 判断为何漏检并归类(无覆盖、覆盖过浅、仅脚本化、质量、非代码、不可观测)。阶段 5 先写会失败的覆盖(RED),阶段 6 修复根因(GREEN),阶段 7 按梯级验证,阶段 8 交接并确认证据。

使用方式:以 $ARGUMENTS 传入缺陷描述,为空时询问哪里坏了;需提供确切的失败代码或请求及确切输出,而非转述。常用命令包括 uv sync --frozen --all-packages --all-groups、pgrep -af amplifier-agent-face、uv run --all-packages python -m pytest <file> -k "<case>"、prek run --all-files、uv run --all-packages python scripts/check.py --runtime,以及 (cd packages/typescript && pnpm test)、(cd evaluations && uv run pytest)。

适用场景:amplifier-agent 的代码缺陷、质量回归、契约歧义与覆盖缺口处理。

限制:不提交、不暂存、不修改测试或评分标准;契约只能由所有者批准的修订变更;不可复现的缺陷无法验证修复;不可观测的问题需用户选择扩展测试装置或记录缺口;具体收费、平台与效果信息暂未提供。