Agentic QA Onboard 是 Agentic QA Boilerplate 仓库的首次导览技能，当用户第一次进入该仓库并询问“从哪里开始”“这里的 QA 怎么运作”，或调用 /agentic-qa-onboard 时激活。它是一个引导者而非执行者：讲解技术栈、QA 流水线（IQL 各阶段，始终按名称称呼：冲刺前的 Shift-Left，然后是 Planning、Execution、Reporting、Documentation、Automation 和 Regression）、MCP 以及所有环节依赖的环境变量，然后交接给合适的下游技能。
用途与定位 该技能专属于这个 Playwright + KATA QA 样板仓库，指向具体入口：/shift-left-testing、/sprint-testing、/test-automation、/test-documentation、/regression-testing、/framework-development。它不做下游工作：冲刺前细化交给 /shift-left-testing，按工单 QA 交给 /sprint-testing，TMS 编写交给 /test-documentation，自动化测试交给 /test-automation，套件运行交给 /regression-testing，新目标仓库交给 /project-discovery，KATA 适配交给 /test-framework-adaptation。
主要能力
- 作为导览，帮助用户明确该调用哪个技能，然后交接并退出。
- 当用户困惑或询问某技能如何工作时，进入教学模式：暂停简洁的工作语气，改用完整句子、温和语气，并在技术术语首次出现时给出定义。
- 镜像用户语言进行解释；可视化演示文稿仅提供西班牙语（技术术语保留英文），在向英语用户打开前会先说明这一点。
- 目标不明确时先问一个问题（是在测试某个工单，还是想了解整个流程？），不会把全部阶段倾倒给只问一个阶段的用户。
- 阶段始终按名称称呼（Shift-Left、Planning、Execution、Reporting、Documentation、Automation、Regression、Observation），不用编号。
- 涉及并行会话时，用通俗语言解释两种执行器（一次性子代理与受监督工作器），然后交接给 /orca-orchestration。
- 在给出任何命令、标志或文件路径之前，先用通俗语言解释概念及其重要性。
- 打开演示文稿前会先询问，因为会启动用户默认浏览器；一次只打开一个。优先使用已发布的 GitHub Pages URL，本地副本仅用于离线或明确要求时。
- 新项目走有序的四阶段设置路径（基础 → Jira 目录 → 发现 + 适配 → git 策略设置）。
- 不凭记忆陈述 Jira 状态或转换；.agents/jira-workflows.json 是权威来源。
- 库文档问题指向 Context7，故障排查指向 web-search 能力，工单写入指向 /acli，详细工单读取指向 Jira 同步脚本。
- 不建议更换技术栈：Playwright + KATA + Allure + TypeScript + bun 是锁定的，KATA 是 Playwright 专用的。
使用方式 当用户首次进入仓库或调用 /agentic-qa-onboard 时激活。技能会讲解技术栈、QA 流水线、MCP 和环境变量，然后指引下游技能。教学模式下，会提供各工作流技能的 how-it-works 演示文稿（西班牙语，单文件 HTML，双击打开，← → 导航，S 查看演讲者备注，O 查看幻灯片概览，F 全屏）。已发布站点为 https://upex-galaxy.github.io/agentic-qa-boilerplate/，演示文稿路径为 .../decks/<folder>/<file>.es.html。文档站点可通过 bun run docs 或 bun run onboarding 打开。
适用场景
- 新用户首次接触该仓库，需要了解整体 QA 流程。
- 用户对某个技能或流程感到困惑，需要通俗解释。
- 需要了解技术栈、环境变量、MCP 或演示文稿目录。
- 需要确定应调用哪个下游技能。
限制
- 不执行下游工作，只做导览与交接。
- 技术栈锁定，不适合需要其他运行器（如 Cypress、Robot Framework）的项目。
- 演示文稿仅西班牙语。
- 打开演示文稿会启动浏览器，必须先询问且一次只开一个。
- 不凭记忆陈述 Jira 状态，以 .agents/jira-workflows.json 为准。
- 仓库不包含被测应用，被测应用位于单独的目标仓库（通过 .agents/project.yaml 配置）。
- 若尚未完成 bun run setup，应先完成基础设置。
技术栈 框架：Playwright（E2E + API）；架构：KATA（TestContext / Base / Domain / Fixture）；报告：Allure；TMS：Jira + Xray Cloud；语言：TypeScript（严格模式）；运行时：bun；Lint/格式：ESLint + Prettier（pre-commit 钩子）；AI 代理：.agents/instructions/agent-harnesses.md 中声明的宿主。
首次设置 克隆后运行一次交互式安装器：bun run setup。它会引导 .agents/、在 harnesses:（.agents/project.yaml）中记录所选代理、询问密钥值存放位置（默认 .env 或密钥管理器）、将 Engram 持久记忆接入每个所选代理（engram setup）、在 .mcp.json 中配置 MCP、下载 Playwright 浏览器等。