SuperAPI AI 工具集

agent-starters

测试与质量

查看项目

更新于 10-16 02:34

技能介绍

用途:验证稳定生产版 NVIDIA Elements CLI 暴露的每个 starter 在真实消费者路径下是否可用。本地仓库构建通过不能替代该生产验证。

主要能力与约束:先运行生产验证器,不得用仓库构建、本地归档、workspace 包或未发布 CLI 替代;每次运行最多修复一个可操作根因、最多开一个 PR,其余失败只报告;生产证据保持不可变,本地源码检查单独记为候选验证;不得为通过验证而修改生成的生产项目、公共 API、无关包、视觉基线、阈值或断言;开 PR 前完整本地 CI 必须通过;远端存在未合并的 topic/starters/* 分支时停止。

准备:读取根 AGENTS.md,运行 git status --short --branch 并保留现有工作;计划运行要求工作树干净。拉取并清理 origin,解析默认分支并从其最新提交开始,不得直接推送默认分支。列出未合并进默认分支的 origin/topic/starters/* 分支,存在则停止并报告。用 gh auth status 确认 GitHub 访问。

运行生产验证:在仓库根执行 mise exec -- node .agents/skills/agent-starters/scripts/index.js。脚本负责 CLI 安装与来源、生产清单发现、项目创建、依赖验证、starter CI 或构建检查、缓存隔离、超时、证据、清理和结果格式化。Node starter 在生成项目暴露该脚本时运行 pnpm run ci,否则运行 pnpm run build;外部工具链 starter 运行其配置的安装与构建命令。不要重复或覆盖其命令、starter 列表、预期或缓存配置。脚本向标准错误输出带时间戳的阶段更新和长命令心跳,并增量更新命令日志;标准输出打印简要报告,写入 results.json,任一必需检查失败时以非零退出。--json 输出结构化标准输出,进度仍在标准错误。每次运行使用检出目录外的新目录,删除成功的生成项目,保留失败项目及证据;仅使用报告中打印的确切清理命令。验证器只向下载的安装器、包和 CI/构建命令传递已批准的环境变量,以及隔离的 home、临时和缓存目录。

失败分类:检查失败 starter 的 result.json、命令日志、保留项目和 CLI 来源,识别首个因果失败并分类为:当前默认分支仍存在的仓库缺陷、生产部署或发布问题、外部注册表/CDN/网络/框架/工具链失败、验证 harness 缺陷、或已被当前 main 或现有工作修复。

修复与验证:编辑前阅读相关 starter 的 AGENTS.md 和项目指南;在 main 上窄复现并添加回归测试;做最小源码修复。按顺序运行窄回归测试、验证器变更时的 mise exec -- node --test .agents/skills/agent-starters/scripts/index.js、受影响项目的 DEVELOPMENT.md 命令、打包或生成输出变更的独立新环境候选验证、格式与 lint 检查、仓库根的 mise exec -- pnpm run ci、git diff --check。

PR:从当前默认分支创建 topic/starters/<short-hyphenated-slug>,只暂存所需文件,使用允许 scope 的 conventional commit、全小写主题、无句号、最多 100 字符并带 Signed-off-by。推送并开一个聚焦的 ready-for-review PR,包含生产 CLI 版本与来源、原始运行位置与失败阶段、首个因果错误与分类证据、聚焦修复与回归覆盖、生产验证与候选验证结果、每条验证命令与结果、以及 PR 外的其他失败。不合并或发布包。

停止条件:全部通过、已存在未合并 topic/starters/* 分支、失败为外部/瞬时/仅部署状态/已修复、重跑不复现且证据不支持仓库缺陷、修复需要公共 API 变更或广泛依赖升级或弱化预期或无关变更或新视觉基线、或必需验证未通过时,均不开 PR。停止即成功运行,需报告生产运行、分类证据、复现结果、保留证据位置、确切停止原因和下一步。

无状态:生产报告、打开的 PR 和远端 topic/starters/* 分支是唯一跨运行状态,不创建日志、账本、标签或跟踪文件;保留的临时证据仅用于诊断,不得用于跳过新的生产运行。