用途
agentic-qa-core 是 agentic-qa-boilerplate 仓库中的共享参考库（Foundation reference host）。它存在的目的是让规范（doctrine）——包括简报模板、派发模式、编排规则、技能组合层级等——集中存放在一处，而不是在每个 SKILL.md 中重复。仓库中的每个工作流技能都会引用它。
加载某个工作流技能（例如 shift-left-testing、sprint-testing、test-automation）时，意味着按需加载相关的 agentic-qa-core/references/*.md。工作流技能在顶部声明一个 ## Dependencies 块，让 AI 知道需要拉取哪些文件。
主要能力
该技能本身不编排工作流、不生成文件、不引导目标仓库。整个框架（技能、基础文件、脚本）作为一个仓库整体发布，不支持单独挑选采用。
它托管了大量参考文档，每份文档被特定的工作流技能引用，用途包括：
- references/test-design-doctrine.md：从验收标准派生测试用例/ATC 的规范，包含 5 项原则、重新定义的覆盖率模型、形式化技术（EP、BVA、状态转换、决策表、Pairwise、错误猜测、基于风险）及测试设计检查清单门禁。
- references/briefing-template.md：7 组件子代理简报模板。
- references/dispatch-patterns.md：选择 Single / Sequential / Parallel / Background 的决策表与启发式。
- references/stage-gates.md：每个工作流阶段的完成定义（DoD）检查清单。
- references/orchestration-doctrine.md：AGENTS.md §3（编排模式）的可缓存镜像。
- references/behavioral-layer.md：AGENTS.md §2 的可缓存镜像（Butler 粒度、PM Voice 语域、Visual Mapping）。
- references/skill-composition-strategy.md：T1-T4 层级模型 + SDD 边界 + 组合契约。
- references/skill-resolver.md：子代理启动时使用的技能解析协议。
- references/preflight-gate.md：就绪预检门禁规范。
- references/mcp-capabilities.md：MCP 能力词汇表。
- references/adr-doctrine.md：测试架构决策何时需要 ADR 及检测→起草→记录流程。
- references/api-testing-doctrine.md：API 测试规范（三工具拆分：OpenAPI MCP 只读、bun run api:login 铸造令牌、curl 执行）。
- references/db-testing-doctrine.md：数据库测试规范（DBHub MCP 作为 [DB_TOOL]）。
- references/mcp-atlassian-optin.md：Atlassian MCP 可选接入块。
- references/planning-ladder.md：QA 规划阶梯。
- references/defect-management-doctrine.md：缺陷提交与归属规范。
- references/traceability-linking.md：将声明的可追溯性转化为真实 Jira 问题链接。
- references/session-management.md：长技能恢复契约。
- references/session-footer-contract.md：面向聊天的收尾契约。
- references/evidence-conventions.md：测试期间产出文件的三桶模型与命名契约。
- references/browser-sessions.md：浏览器会话规范。
- references/acli-integration.md：QA 侧对工具无关 acli 技能的接入。
- references/jira-publishing-gotchas.md：Markdown → ADF 转换在发布时产生 HTTP 400 的边界情况。
- references/skill-refinement-protocol.md：会话如何为技能提出经验教训而非直接编辑。
- references/skill-scaffold.md：每个新 T1 技能诞生时的契约。
- references/upstream-feedback.md：针对 boilerplate 提交技能问题。
- references/artifact-lifecycle.md：每个 harness 产物的状态生命周期。
- references/decision-protocol.md：决定一个问题是否应到达人。
- references/decision-elicitation-doctrine.md：harness 如何请求人做决定。
- references/secret-hygiene.md：关键规则 #1（凭据按名称而非值）的规范。
使用方式
- 当工作流技能引用 agentic-qa-core/references/*.md 时，只加载该技能 ## Dependencies 块中列出的文件，绝不预加载整个参考集。
- 在任何测试技能中从验收标准派生测试用例或覆盖率时，必须先阅读 references/test-design-doctrine.md。
- 提交任何 bug/缺陷/改进时，必须先阅读 references/defect-management-doctrine.md。
- 派发子代理时，使用 references/briefing-template.md 中的 7 组件简报，并通过 references/dispatch-patterns.md 选择模式。
- 关闭工作流阶段时，在推进之前先验证 references/stage-gates.md 中该阶段的完成定义。
- 在准备请人做决定或在可辩护的选项之间选择时，先运行 references/decision-protocol.md。
- 当规则变化时，编辑所属技能的 references/*.md，然后运行 bun run skills:registry，再刷新 packages/decks/agentic-qa-core/ 下的 deck。
适用场景
适用于 agentic-qa-boilerplate 仓库内的所有工作流技能，作为共享规范的唯一来源。
限制
- 作为 agentic-qa-core 时，不得创建、修改或删除任何文件。它是一个被动的参考库，没有自己的写入路径。
- 不得在此写入 .context/ 产物、搭建测试/夹具/KATA 组件、将框架适配到技术栈或同步 OpenAPI schema。
- 不得从此技能编排工作流或引导目标仓库。
- 必须仅按名称使用每个凭据、令牌或会话文件，绝不打开 .env*（除 .env.example 和已提交的 .env*.schema 文件）、.auth/** 或 .claude/settings.local.json，绝不运行 printenv / env / echo $SECRET / set -x / curl -v。
- 此 boilerplate 必须整体克隆；单独复制一个技能目录会使其缺少所依赖的基础文件而无法运行。
安装模型
整个框架（技能、基础文件、脚本）作为一个仓库整体发布，不支持单独挑选采用。