用途:当项目希望采用 Allure agent-mode 进行测试工作和测试评审时使用本技能。凡是执行测试且结果将用于冒烟检查、推理、评审、覆盖率分析、调试或任何面向用户的结论,都应通过 allure agent 运行;它会保留原始控制台日志,并在不继承项目配置中常规报告或导出插件的情况下添加 agent-mode 产物。即使改动很小或机械,冒烟检查也应使用 allure agent。只有在无法使用或正在调试 agent mode 本身时才跳过。
目标:让项目留下根 AGENTS.md,将测试工作路由到 docs/allure-agent-mode.md;创建项目 docs/allure-agent-mode.md 指南;提供足够的 Allure 引导信息,即使项目尚未完全配置,agent 也能继续。
工作流:检查项目是否已产出 Allure 结果或已有 Allure 配置;若缺失,添加或建议最小可行的安装/配置路径,视为尽力而为的引导而非主要验收路径;创建或更新根 AGENTS.md,使测试相关工作指向 docs/allure-agent-mode.md;基于内置模板创建 docs/allure-agent-mode.md,仅调整必须项目特定的部分。
帮助命令:保持简短实用,包含 allure agent latest、allure agent state-dir、allure agent select --latest / --from <output-dir>、allure agent --rerun-latest / --rerun-from <output-dir>,便于恢复最新输出目录、查看状态存储位置、查看面向评审的测试计划并重跑相同范围。另加一个紧凑的 Advanced Reruns 小节,记录 --rerun-preset、--rerun-environment、--rerun-label 和 ALLURE_AGENT_STATE_DIR,不要写成完整 CLI 参考。验证部分应明确 agent 在测试执行后打印本次运行的 index.md 路径。
文件:项目指南模板 references/project-guide-template.md;根路由片段 references/root-agents-snippet.md。
限制:保持 AGENTS.md 简短,只做路由,不复制整份指南;帮助命令说明保持简短,优先一行描述;不要发明项目特定的元数据约定,除非仓库已在使用;不要在项目指南中创建持久输出或期望路径,它们是每次运行的临时产物;若项目已有更好的 Allure 说明,应谨慎合并而非覆盖。