SuperAPI AI 工具集

allure-agent-mode-feature-delivery

测试与质量

查看项目

更新于 10-15 19:55

技能介绍

用途:该技能面向会改动测试的功能或缺陷工作,也用于审查现有测试、审计覆盖率、分诊失败套件、排查证据薄弱以及调试不稳定或环境敏感的失败。

主要能力:通过 allure agent 运行测试,保留原始控制台日志,并添加 agent-mode 产物,同时不继承项目配置中的常规报告或导出插件。即使改动很小或只是机械性修改,冒烟检查也建议使用 allure agent;只有在无法使用或正在调试 agent mode 本身时才跳过。

使用方式:若项目存在 docs/allure-agent-mode.md,应在编写或审查测试前先阅读;否则按本技能指引操作,并建议稍后运行 setup 技能。工作流为:理解功能、问题或审查目标并确定预期测试范围;在临时目录为本轮运行创建新的期望文件;编写或更新测试(仅审查任务可保持不变);先用 allure agent 只运行预期范围,再依赖原始控制台输出;先审查 index.md、manifest/run.json、manifest/tests.jsonl、manifest/findings.jsonl 及相关测试 markdown 文件,再检查源码;若证据薄弱,用真实步骤、附件或最小元数据充实测试;用新的临时输出目录和新的期望文件重跑;仅当范围匹配、证据足以审查且部分运行时建模已明确说明时才接受。

命令示例: TMP_DIR="$(mktemp -d)" EXPECTATIONS="$TMP_DIR/expectations.yaml"

npx allure agent
--output "$TMP_DIR/agent-output"
--expectations "$EXPECTATIONS"
-- npm test -- <scope>

要求与限制:每次运行必须使用唯一的临时 ALLURE_AGENT_OUTPUT 和 ALLURE_AGENT_EXPECTATIONS,并行运行不得共享这些路径;v1 优先使用 YAML 期望;宽泛的包健康审计可省略期望,但审查必须指出范围检查较弱;元数据充实属于该循环的一部分。护栏包括:运行时优先、源码其次;步骤必须代表真实行为;附件必须来自当前执行;元数据保持最小;优先在辅助边界插桩;若运行器可见的失败未表示为逻辑测试,应检查全局 stderr 并将该次运行视为部分运行时审查。参考文件为 references/expectations-example.yaml。