菜单
基于当前 PRD 和业务上下文，通过 test-knowledge-mcp 检索并组织测试知识库资料。适用于需要为 prd-to-xmind-testcases、UI 自动化、API 自动化、Traceability、回归分析、影响面分析提供历史 PRD、历史测试用例、历史缺陷、接口文档、上下游说明、发布说明、shared 规则等结构化上下文的场景。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | test-knowledge-retrieval |
| description | 基于当前 PRD 和业务上下文，通过 test-knowledge-mcp 检索并组织测试知识库资料。适用于需要为 prd-to-xmind-testcases、UI 自动化、API 自动化、Traceability、回归分析、影响面分析提供历史 PRD、历史测试用例、历史缺陷、接口文档、上下游说明、发布说明、shared 规则等结构化上下文的场景。 |
本 skill 只负责“检索与上下文组织”。
必须执行：
test-knowledge-mcp 检索和读取测试知识库资料。context-retrieval.md 和 context-package.json。禁止执行：
test-knowledge-mcp 直接扫描或读取知识库目录。.xmind 文件。知识库相关操作必须通过 test-knowledge-mcp 完成：
validate_knowledge_basesearch_contextread_context_documentslist_module_assets如果 test-knowledge-mcp 不可用，必须停止并提示用户。禁止自行扫描知识库兜底。
执行检索前必须确认知识库根目录来源，并在 context-retrieval.md 的 Knowledge Roots 或 Retrieval Summary 中记录结论。
MCP 的知识库来源包括：
knowledge-baseTEST_KNOWLEDGE_ROOTS必须注意：
search_context 会在 MCP 允许的 knowledge roots 中检索，skill 不得自行读取 TEST_KNOWLEDGE_ROOTS 指向目录。validate_knowledge_base、scan_knowledge_base、refresh_knowledge_index 如果传入 root_path，必须传 knowledge root 本身，禁止传项目根目录。knowledge-base 为空，不能直接判定 knowledge_not_found，必须继续执行同 system 和全库关键词降级检索，让 MCP 覆盖环境变量中的 roots。写文件前必须确认项目根目录是包含 .codex 的目录。
所有产物写入：
./<delivery-name>/analysis/
必需产物：
./<delivery-name>/analysis/context-retrieval.md
./<delivery-name>/analysis/context-package.json
禁止把执行产物写入 .codex/、.codex/skills/ 或 skill 目录。
从当前 PRD 和用户补充上下文中提取或谨慎推断：
systemmoduleversionbusiness_objectsinterfacesstatesrolesupstream_dependenciesdownstream_dependencieskeywordsrisk_keywordsdiff 或 release note 线索无法推断的字段保持为空，并写入 open_questions。禁止臆造。
在 context-retrieval.md 中输出 Retrieval Plan，至少包含：
当知识库状态不明确时，先调用 validate_knowledge_base。
必须按以下降级链路调用 search_context，禁止跳过中间步骤后直接标记 knowledge_not_found。
使用最可靠的精确字段检索：
systemmodulebusiness_objectsinterfacesstatesrolesupstream_dependenciesdownstream_dependencieskeywords如果命中有效结果，进入相关性分级和读取阶段。
如果精确 module 无有效结果，必须将 module 置空或省略，保留 system 和业务检索条件，再次调用 search_context：
system=<当前 system>module=""命中后按实际匹配信号重新分级。不能因为不是精确 module 就全部丢弃。
如果同 system 仍无有效结果，必须执行全库关键词检索：
system=""module=""全库关键词命中的结果默认最多作为中相关或弱相关；只有同时命中业务对象、接口、状态、流程或历史版本关系时，才允许升级为强相关。
只有精确 module、同 system、全库 keywords 三层检索均无有效结果，才允许设置：
"knowledge_not_found": true
每一层检索都必须记录到 context-package.json.retrieval_summary.search_attempts，并写入 context-retrieval.md 的 Search Attempts。
检索覆盖范围必须包括：
优先使用多次精准检索，避免一次性全库宽泛检索。禁止读取整个知识库。
当 PRD 中 module 可能是版本化组合名时，必须生成模块别名并纳入全库 keywords 降级检索。
示例：
V5.6.1(在线看片自助裁剪)自助裁剪、在线看片自助裁剪、小程序自助裁剪、取片服务小程序 / 自助裁剪、V5.6.0(小程序自助裁剪)模块别名只能作为检索关键词或候选 module 说明，不能当作已确认事实写入最终业务结论。
读取正文前先分级：
strong_related：同 module，并命中业务对象、接口、流程、状态、角色、风险关键词或 diff。medium_related：上下游依赖、shared 规则、同 system 不同 module。weak_related：只有关键词相似，或表述相似但业务对象不同。弱相关默认只记录摘要，不把正文写入 context-package.json。
必须调用 read_context_documents。
max_chars_per_doc 限制内读取较完整正文。历史测试用例规则：
.md 是 AI source，优先读取 .md。.xmind，只返回 xmind_path 和 xmind_exists。.xmind。按 references/context-package-schema.md 生成合法 JSON。
字段填充规则：
reused_testcases 只放入与当前范围实质匹配的历史测试用例。regression_candidates 只有在命中当前模块、接口、状态流转、业务对象、风险关键词或 diff 时才能写入。risk_candidates 必须关注历史线上缺陷、高频缺陷、幂等、并发、状态错乱、通知重复、异步延迟、回滚失败、接口兼容、权限绕过。upstream_dependencies 和 downstream_dependencies 来源于相关资产或当前 PRD 显式描述。shared_rules 只写入与当前范围相关的 shared 规则。conflicts 记录当前 PRD 与历史 PRD、历史测试用例、缺陷、接口文档、发布说明、shared 规则之间的冲突。open_questions 记录缺失字段、归属不清、冲突待确认等问题。选择回归候选时读取 references/regression-selection.md。记录冲突时读取 references/conflict-detection.md。
写入 context-retrieval.md，必须包含：
# Context Retrieval
## Knowledge Roots
## Retrieval Plan
## Search Attempts
### Exact Module Search
### System-Level Fallback Search
### Global Keyword Fallback Search
### Final Decision
## Retrieval Summary
## Strong Related Assets
## Medium Related Assets
## Weak Related Assets
## Reused Testcases
## Regression Candidates
## Risk Candidates
## Upstream Dependencies
## Downstream Dependencies
## Shared Rules
## Conflicts
## Open Questions
内容必须简洁、可追溯。禁止粘贴完整大文档、完整历史 PRD 或完整历史测试用例集。
如果 search_context 没有返回有效结果：
retrieval_summary.knowledge_not_found 为 true。open_questions 中记录缺失知识或需要补充的元数据。禁止臆造历史上下文。
references/context-retrieval.md：检索计划、查询策略和相关性分级。references/regression-selection.md：回归候选和风险候选选择规则。references/conflict-detection.md：冲突识别和记录格式。references/context-package-schema.md：context-package.json 结构规范。examples/context-retrieval.sample.mdexamples/context-package.sample.jsonexamples/regression-candidates.sample.json对已生成的 UI DSL 做生产级 selector 补全与校准，支持 dry 候选生成和 probe 受控状态推进两种模式。适用于读取交付目录中的 ui-dsl/ui-test.dsl.yaml，通过 seed selector、安全 click、runtime-confirmed click、reuse-session 和 Playwright locator count 校准 todo selector，并输出 enriched DSL、补全报告和未解决清单；不生成 spec，不运行测试，不做业务断言。
将 Markdown PRD 按复杂度自适应解析为可导入 XMind 的测试用例树，并输出 Markdown、JSON、CSV 与 pipeline-output.json。适用于读取当前 PRD，按需触发 test-knowledge-retrieval，消费 context package，执行 analysis-lite 或完整系统建模，经过 testpoint 与 testcase-expansion 矩阵展开后生成测试用例。
调度 AI 测试流水线，从 PRD Markdown 文件、PRD Markdown 内容或已有 delivery-name 开始，按需串联 prd-to-xmind-testcases、testcase-to-playwright-dsl、dsl-selector-enrichment、playwright-dsl-to-spec 和 playwright-cli。适用于完整执行 PRD 到 Playwright 测试、指定 only/resume 阶段、从已有测试用例/DSL/spec 继续、执行 selector enrichment 或运行 Playwright 的场景。
Drive browser sessions with the `playwright-cli` command for UI inspection, browser automation, page interaction, debugging, storage/session management, request mocking, tracing, video recording, and generating or running Playwright-oriented workflows. Use when the user asks Codex to open a page, navigate, click/type/select/upload/check elements, inspect snapshots or element attributes, manage tabs/cookies/localStorage/sessionStorage, mock network requests, capture traces/videos/screenshots/PDFs, run Playwright snippets, or debug Playwright tests via the CLI.
将符合 .codex/skills/testcase-to-playwright-dsl/references/dsl-schema.md 的 ui-test.dsl.yaml 转换为 Playwright spec.ts。适用于 Codex 读取交付目录中的 ui-dsl/ui-test.dsl.yaml 并生成 playwright/tests/*.spec.ts；严格按 DSL schema 解析字段，不新增 DSL 字段，不修改 testcase-to-playwright-dsl skill，不执行 Playwright，不运行 npx playwright test。
从已有 Playwright 执行产物生成生产级 Markdown 测试报告。用于解析交付目录中的 playwright/results.json、test-results、spec 和 ui-dsl YAML，并把 Playwright 失败关联回 DSL flow、step、source_ts、selector、截图、trace 和 video；不执行测试，不生成 spec，不修改 DSL/spec 文件。