@pzy560117/opentest 0.1.9 → 0.1.11

package/scripts/smoke-test.js

@@ -182,7 +182,7 @@ function assertDefaultPytestContracts() {
   assert(stateScript.includes('test_framework|'), '[PYTEST] state script must allow test_framework field updates');
   assert(detectScript.includes('default_test_framework: pytest'), '[PYTEST] detect summary must report pytest as default framework');
   assert(detectScript.includes('pytest_command:'), '[PYTEST] detect summary must report pytest command status');
-  assert(englishAuthor.includes('Default to pytest'), '[PYTEST] English author skill must default missing framework to pytest');
+  assert(englishAuthor.includes('default to pytest'), '[PYTEST] English author skill must default missing framework to pytest');
   assert(chineseAuthor.includes('默认使用 pytest'), '[PYTEST] Chinese author skill must default missing framework to pytest');
   assert(englishRun.includes('python -m pytest'), '[PYTEST] English run skill must document pytest command');
   assert(chineseRun.includes('python -m pytest'), '[PYTEST] Chinese run skill must document pytest command');
@@ -192,6 +192,308 @@ function assertDefaultPytestContracts() {
   assert(chineseMatrix.includes('覆盖维度') && chineseMatrix.includes('框架/命令') && chineseMatrix.includes('缺口/阻塞'), '[COVERAGE] Chinese matrix template must include coverage, command, and gap columns');
 }
 
+function assertRequirementFirstAcceptanceContracts() {
+  const englishWorkflow = readFileSync('assets/skills/opentest/references/complete-testing-workflow.md', 'utf8');
+  const chineseWorkflow = readFileSync('assets/skills-zh/opentest/references/complete-testing-workflow.md', 'utf8');
+  const englishDriven = readFileSync('assets/skills/opentest/references/opentest-driven-development.md', 'utf8');
+  const chineseDriven = readFileSync('assets/skills-zh/opentest/references/opentest-driven-development.md', 'utf8');
+  const englishMatrixFormat = readFileSync('assets/skills/opentest/references/matrix-format.md', 'utf8');
+  const chineseMatrixFormat = readFileSync('assets/skills-zh/opentest/references/matrix-format.md', 'utf8');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishAuthor = readFileSync('assets/skills/opentest-author/SKILL.md', 'utf8');
+  const chineseAuthor = readFileSync('assets/skills-zh/opentest-author/SKILL.md', 'utf8');
+  const englishMatrix = readFileSync('assets/skills/opentest/templates/matrix-template.md', 'utf8');
+  const chineseMatrix = readFileSync('assets/skills-zh/opentest/templates/matrix-template.md', 'utf8');
+
+  assert(englishDriven.includes('Requirement-First Contract'), '[REQFIRST] English driven-development reference must define requirement-first contract');
+  assert(chineseDriven.includes('需求先行契约'), '[REQFIRST] Chinese driven-development reference must define requirement-first contract');
+  assert(englishWorkflow.includes('Requirement-First Acceptance'), '[REQFIRST] English workflow must include requirement-first acceptance gate');
+  assert(chineseWorkflow.includes('需求先行验收'), '[REQFIRST] Chinese workflow must include requirement-first acceptance gate');
+  assert(englishMatrixFormat.includes('Requirement source') && englishMatrixFormat.includes('Do not use a function name'), '[REQFIRST] English matrix format must require requirement source and reject implementation-derived sources');
+  assert(chineseMatrixFormat.includes('需求来源') && chineseMatrixFormat.includes('不要把函数名'), '[REQFIRST] Chinese matrix format must require requirement source and reject implementation-derived sources');
+  assert(englishMatrix.includes('Requirement source') && englishMatrix.includes('REQ-001'), '[REQFIRST] English matrix template must include requirement source examples');
+  assert(chineseMatrix.includes('需求来源') && chineseMatrix.includes('REQ-001'), '[REQFIRST] Chinese matrix template must include requirement source examples');
+  assert(englishPlan.includes('current code only for project facts') && englishPlan.includes('Do not drop or narrow acceptance'), '[REQFIRST] English plan skill must prevent implementation-derived acceptance');
+  assert(chinesePlan.includes('读取当前代码只用于发现项目事实') && chinesePlan.includes('不得因为当前代码没有对应函数'), '[REQFIRST] Chinese plan skill must prevent implementation-derived acceptance');
+  assert(englishAuthor.includes('Missing implementation means evidence stays pending'), '[REQFIRST] English author skill must keep requirements when implementation is missing');
+  assert(chineseAuthor.includes('实现缺失只表示证据 pending'), '[REQFIRST] Chinese author skill must keep requirements when implementation is missing');
+}
+
+function assertTestSurfaceContracts() {
+  const manifestText = readFileSync('assets/manifest.json', 'utf8');
+  const englishSurfaces = readRequiredText('assets/skills/opentest/references/test-surfaces.md', '[SURFACE] missing English test-surfaces reference');
+  const chineseSurfaces = readRequiredText('assets/skills-zh/opentest/references/test-surfaces.md', '[SURFACE] missing Chinese test-surfaces reference');
+  const englishMatrixFormat = readFileSync('assets/skills/opentest/references/matrix-format.md', 'utf8');
+  const chineseMatrixFormat = readFileSync('assets/skills-zh/opentest/references/matrix-format.md', 'utf8');
+  const englishWorkflow = readFileSync('assets/skills/opentest/references/complete-testing-workflow.md', 'utf8');
+  const chineseWorkflow = readFileSync('assets/skills-zh/opentest/references/complete-testing-workflow.md', 'utf8');
+  const englishHeuristics = readFileSync('assets/skills/opentest/references/codex-harness-coverage-heuristics.md', 'utf8');
+  const chineseHeuristics = readFileSync('assets/skills-zh/opentest/references/codex-harness-coverage-heuristics.md', 'utf8');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishRun = readFileSync('assets/skills/opentest-run/SKILL.md', 'utf8');
+  const chineseRun = readFileSync('assets/skills-zh/opentest-run/SKILL.md', 'utf8');
+  const englishAccept = readFileSync('assets/skills/opentest-accept/SKILL.md', 'utf8');
+  const chineseAccept = readFileSync('assets/skills-zh/opentest-accept/SKILL.md', 'utf8');
+  const englishMatrix = readFileSync('assets/skills/opentest/templates/matrix-template.md', 'utf8');
+  const chineseMatrix = readFileSync('assets/skills-zh/opentest/templates/matrix-template.md', 'utf8');
+  const englishPlanTemplate = readFileSync('assets/skills/opentest/templates/plan-template.md', 'utf8');
+  const chinesePlanTemplate = readFileSync('assets/skills-zh/opentest/templates/plan-template.md', 'utf8');
+  const englishAcceptance = readFileSync('assets/skills/opentest/templates/acceptance-template.md', 'utf8');
+  const chineseAcceptance = readFileSync('assets/skills-zh/opentest/templates/acceptance-template.md', 'utf8');
+  const surfaces = ['web-browser', 'android-app', 'desktop-gui', 'api'];
+
+  assert(manifestText.includes('opentest/references/test-surfaces.md'), '[SURFACE] manifest must ship test-surfaces reference');
+
+  for (const surface of surfaces) {
+    assert(englishSurfaces.includes(surface), `[SURFACE] English test-surfaces missing ${surface}`);
+    assert(chineseSurfaces.includes(surface), `[SURFACE] Chinese test-surfaces missing ${surface}`);
+    assert(englishMatrixFormat.includes(surface), `[SURFACE] English matrix-format missing ${surface}`);
+    assert(chineseMatrixFormat.includes(surface), `[SURFACE] Chinese matrix-format missing ${surface}`);
+    assert(englishMatrix.includes(surface), `[SURFACE] English matrix template missing ${surface}`);
+    assert(chineseMatrix.includes(surface), `[SURFACE] Chinese matrix template missing ${surface}`);
+  }
+
+  assert(englishSurfaces.includes('Do not invent a fifth primary surface'), '[SURFACE] English reference must forbid fifth primary surface');
+  assert(chineseSurfaces.includes('不要发明第五种主执行面'), '[SURFACE] Chinese reference must forbid fifth primary surface');
+  assert(englishSurfaces.includes('android-midscene-pytest') && englishSurfaces.includes('Midscene HTML report') && englishSurfaces.includes('logcat'), '[SURFACE] English Android route must require Midscene and logcat evidence');
+  assert(chineseSurfaces.includes('android-midscene-pytest') && chineseSurfaces.includes('Midscene HTML 报告') && chineseSurfaces.includes('logcat'), '[SURFACE] Chinese Android route must require Midscene and logcat evidence');
+  assert(englishSurfaces.includes('Midscene YAML runner') && englishSurfaces.includes('MIDSCENE_MCP_ANDROID_MODE=true') && englishSurfaces.includes('midscene-python'), '[SURFACE] English Android route must document YAML, MCP, and midscene-python boundaries');
+  assert(chineseSurfaces.includes('Midscene YAML runner') && chineseSurfaces.includes('MIDSCENE_MCP_ANDROID_MODE=true') && chineseSurfaces.includes('midscene-python'), '[SURFACE] Chinese Android route must document YAML, MCP, and midscene-python boundaries');
+  assert(englishSurfaces.includes('npm run test:android') && englishSurfaces.includes('midscene_run/log/ai-call.log') && englishSurfaces.includes('midscene_run/report/*.html'), '[SURFACE] English Android route must document layered run and failure artifacts');
+  assert(chineseSurfaces.includes('npm run test:android') && chineseSurfaces.includes('midscene_run/log/ai-call.log') && chineseSurfaces.includes('midscene_run/report/*.html'), '[SURFACE] Chinese Android route must document layered run and failure artifacts');
+  assert(englishSurfaces.includes('opentest-desktop-gui') && englishSurfaces.includes('@midscene/computer') && englishSurfaces.includes('deterministic read/assert changed result'), '[SURFACE] English desktop route must document opentest-desktop-gui and deterministic read-back');
+  assert(chineseSurfaces.includes('opentest-desktop-gui') && chineseSurfaces.includes('@midscene/computer') && chineseSurfaces.includes('确定性 read/assert changed result'), '[SURFACE] Chinese desktop route must document opentest-desktop-gui and deterministic read-back');
+  assert(englishSurfaces.includes('opentest-api') && englishSurfaces.includes('httpx') && englishSurfaces.includes('read-after-write'), '[SURFACE] English API route must document opentest-api and read-after-write');
+  assert(chineseSurfaces.includes('opentest-api') && chineseSurfaces.includes('httpx') && chineseSurfaces.includes('写后读'), '[SURFACE] Chinese API route must document opentest-api and read-after-write');
+  assert(englishWorkflow.includes('Execution Surfaces') && englishWorkflow.includes('android-midscene-pytest'), '[SURFACE] English workflow must include execution surface rules');
+  assert(chineseWorkflow.includes('执行面') && chineseWorkflow.includes('android-midscene-pytest'), '[SURFACE] Chinese workflow must include execution surface rules');
+  assert(englishWorkflow.includes('opentest-desktop-gui') && englishWorkflow.includes('@midscene/computer'), '[SURFACE] English workflow must include desktop GUI route');
+  assert(chineseWorkflow.includes('opentest-desktop-gui') && chineseWorkflow.includes('@midscene/computer'), '[SURFACE] Chinese workflow must include desktop GUI route');
+  assert(englishWorkflow.includes('opentest-api') && englishWorkflow.includes('httpx'), '[SURFACE] English workflow must include API route');
+  assert(chineseWorkflow.includes('opentest-api') && chineseWorkflow.includes('httpx'), '[SURFACE] Chinese workflow must include API route');
+  assert(englishHeuristics.includes('Execution Surface Selection') && englishHeuristics.includes('android-midscene-pytest'), '[SURFACE] English heuristics must include surface selection');
+  assert(chineseHeuristics.includes('执行面选择') && chineseHeuristics.includes('android-midscene-pytest'), '[SURFACE] Chinese heuristics must include surface selection');
+  assert(englishHeuristics.includes('opentest-desktop-gui') && englishHeuristics.includes('@midscene/computer'), '[SURFACE] English heuristics must include desktop GUI route');
+  assert(chineseHeuristics.includes('opentest-desktop-gui') && chineseHeuristics.includes('@midscene/computer'), '[SURFACE] Chinese heuristics must include desktop GUI route');
+  assert(englishHeuristics.includes('opentest-api') && englishHeuristics.includes('httpx'), '[SURFACE] English heuristics must include API route');
+  assert(chineseHeuristics.includes('opentest-api') && chineseHeuristics.includes('httpx'), '[SURFACE] Chinese heuristics must include API route');
+
+  for (const skillContent of [englishPlan, chinesePlan, englishRun, chineseRun, englishAccept, chineseAccept]) {
+    assert(skillContent.includes('opentest/references/test-surfaces.md'), '[SURFACE] plan/run/accept skills must read test-surfaces reference');
+  }
+
+  assert(englishPlan.includes('execution surface and evidence layer separately'), '[SURFACE] English plan must split surface and evidence layer');
+  assert(chinesePlan.includes('分开判定执行面和证据层级'), '[SURFACE] Chinese plan must split surface and evidence layer');
+  assert(englishRun.includes('matrix execution surface') && englishRun.includes('python -m pytest tests_py -v'), '[SURFACE] English run must route by execution surface');
+  assert(chineseRun.includes('矩阵执行面') && chineseRun.includes('python -m pytest tests_py -v'), '[SURFACE] Chinese run must route by execution surface');
+  assert(englishRun.includes('npm run test:android') && englishRun.includes('model env'), '[SURFACE] English run must gate npm run test:android behind model env/debugging');
+  assert(chineseRun.includes('npm run test:android') && chineseRun.includes('模型环境变量'), '[SURFACE] Chinese run must gate npm run test:android behind model env/debugging');
+  assert(englishAccept.includes('android-midscene-pytest') && englishAccept.includes('ADB smoke') && englishAccept.includes('midscene_run'), '[SURFACE] English accept must route Android through android-midscene-pytest');
+  assert(chineseAccept.includes('android-midscene-pytest') && chineseAccept.includes('ADB 冒烟') && chineseAccept.includes('midscene_run'), '[SURFACE] Chinese accept must route Android through android-midscene-pytest');
+  assert(englishAccept.includes('opentest-desktop-gui') && englishAccept.includes('@midscene/computer'), '[SURFACE] English accept must route desktop GUI through opentest-desktop-gui');
+  assert(chineseAccept.includes('opentest-desktop-gui') && chineseAccept.includes('@midscene/computer'), '[SURFACE] Chinese accept must route desktop GUI through opentest-desktop-gui');
+  assert(englishAccept.includes('opentest-api') && englishAccept.includes('httpx') && englishAccept.includes('cleanup/teardown'), '[SURFACE] English accept must route API through opentest-api');
+  assert(chineseAccept.includes('opentest-api') && chineseAccept.includes('httpx') && chineseAccept.includes('cleanup/teardown'), '[SURFACE] Chinese accept must route API through opentest-api');
+
+  assert(englishMatrix.includes('Execution surface') && englishMatrix.includes('Evidence layer') && englishMatrix.includes('Midscene HTML report') && englishMatrix.includes('python -m pytest tests_py -v') && englishMatrix.includes('ADB smoke') && englishMatrix.includes('midscene_run'), '[SURFACE] English matrix template must include execution surface and Android artifacts');
+  assert(chineseMatrix.includes('执行面') && chineseMatrix.includes('证据层级') && chineseMatrix.includes('Midscene HTML 报告') && chineseMatrix.includes('python -m pytest tests_py -v') && chineseMatrix.includes('ADB 冒烟') && chineseMatrix.includes('midscene_run'), '[SURFACE] Chinese matrix template must include execution surface and Android artifacts');
+  assert(englishMatrix.includes('opentest-desktop-gui') && englishMatrix.includes('@midscene/computer') && englishMatrix.includes('deterministic read-back'), '[SURFACE] English matrix template must include desktop GUI artifacts');
+  assert(chineseMatrix.includes('opentest-desktop-gui') && chineseMatrix.includes('@midscene/computer') && chineseMatrix.includes('确定性回读'), '[SURFACE] Chinese matrix template must include desktop GUI artifacts');
+  assert(englishMatrix.includes('opentest-api') && englishMatrix.includes('python -m pytest tests/api -v') && englishMatrix.includes('payload/schema assertion') && englishMatrix.includes('cleanup/teardown'), '[SURFACE] English matrix template must include API artifacts');
+  assert(chineseMatrix.includes('opentest-api') && chineseMatrix.includes('python -m pytest tests/api -v') && chineseMatrix.includes('payload/schema 断言') && chineseMatrix.includes('cleanup/teardown'), '[SURFACE] Chinese matrix template must include API artifacts');
+  assert(englishPlanTemplate.includes('| Execution surface | Acceptance mode | Evidence layer |'), '[SURFACE] English plan template must split surface and evidence layer');
+  assert(chinesePlanTemplate.includes('| 执行面 | 验收模式 | 证据层级 |'), '[SURFACE] Chinese plan template must split surface and evidence layer');
+  assert(englishAcceptance.includes('execution surface: web-browser | android-app | desktop-gui | api') && englishAcceptance.includes('evidence layer'), '[SURFACE] English acceptance template must include surface and evidence layer fields');
+  assert(chineseAcceptance.includes('执行面: web-browser | android-app | desktop-gui | api') && chineseAcceptance.includes('证据层级'), '[SURFACE] Chinese acceptance template must include surface and evidence layer fields');
+}
+
+function assertWebBrowserContracts() {
+  const manifestText = readFileSync('assets/manifest.json', 'utf8');
+  const englishSkill = readRequiredText('assets/skills/opentest-web-browser/SKILL.md', '[WEB] missing English web-browser skill');
+  const chineseSkill = readRequiredText('assets/skills-zh/opentest-web-browser/SKILL.md', '[WEB] missing Chinese web-browser skill');
+  const englishReference = readRequiredText('assets/skills/opentest/references/web-browser-testing.md', '[WEB] missing English web-browser reference');
+  const chineseReference = readRequiredText('assets/skills-zh/opentest/references/web-browser-testing.md', '[WEB] missing Chinese web-browser reference');
+  const englishTemplate = readRequiredText('assets/skills/opentest/templates/web-acceptance-template.md', '[WEB] missing English web acceptance template');
+  const chineseTemplate = readRequiredText('assets/skills-zh/opentest/templates/web-acceptance-template.md', '[WEB] missing Chinese web acceptance template');
+  const englishMatrix = readFileSync('assets/skills/opentest/templates/matrix-template.md', 'utf8');
+  const chineseMatrix = readFileSync('assets/skills-zh/opentest/templates/matrix-template.md', 'utf8');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishRun = readFileSync('assets/skills/opentest-run/SKILL.md', 'utf8');
+  const chineseRun = readFileSync('assets/skills-zh/opentest-run/SKILL.md', 'utf8');
+  const englishAccept = readFileSync('assets/skills/opentest-accept/SKILL.md', 'utf8');
+  const chineseAccept = readFileSync('assets/skills-zh/opentest-accept/SKILL.md', 'utf8');
+  const allWebText = [
+    englishSkill,
+    chineseSkill,
+    englishReference,
+    chineseReference,
+    englishTemplate,
+    chineseTemplate,
+  ].join('\n');
+
+  assert(manifestText.includes('opentest-web-browser/SKILL.md'), '[WEB] manifest must ship opentest-web-browser skill');
+  assert(manifestText.includes('opentest/references/web-browser-testing.md'), '[WEB] manifest must ship web-browser-testing reference');
+  assert(manifestText.includes('opentest/templates/web-acceptance-template.md'), '[WEB] manifest must ship web acceptance template');
+
+  for (const mode of ['instant-acceptance', 'durable-regression', 'visual-ai-assist']) {
+    assert(englishReference.includes(mode), `[WEB] English reference missing mode ${mode}`);
+    assert(chineseReference.includes(mode), `[WEB] Chinese reference missing mode ${mode}`);
+    assert(englishMatrix.includes(mode), `[WEB] English matrix missing mode ${mode}`);
+    assert(chineseMatrix.includes(mode), `[WEB] Chinese matrix missing mode ${mode}`);
+  }
+
+  assert(englishSkill.includes('Playwright MCP') && englishSkill.includes('Playwright CLI') && englishSkill.includes('@playwright/test') && englishSkill.includes('Midscene'), '[WEB] English web skill must route MCP, CLI, Playwright Test, and Midscene');
+  assert(chineseSkill.includes('Playwright MCP') && chineseSkill.includes('Playwright CLI') && chineseSkill.includes('@playwright/test') && chineseSkill.includes('Midscene'), '[WEB] Chinese web skill must route MCP, CLI, Playwright Test, and Midscene');
+  assert(englishReference.includes('MCP and Playwright CLI are immediate acceptance tools') && englishReference.includes('not durable regression'), '[WEB] English reference must distinguish immediate acceptance from durable regression');
+  assert(chineseReference.includes('现场验收工具') && chineseReference.includes('不等于稳定回归'), '[WEB] Chinese reference must distinguish immediate acceptance from durable regression');
+  assert(englishReference.includes('Midscene is a supplemental AI visual UI automation layer'), '[WEB] English reference must position Midscene as supplemental');
+  assert(chineseReference.includes('Midscene 是 AI 视觉 UI 自动化补充层'), '[WEB] Chinese reference must position Midscene as supplemental');
+  assert(englishTemplate.includes('read/assert changed result') && chineseTemplate.includes('read/assert changed result'), '[WEB] web acceptance templates must require post-submit read/assert');
+
+  for (const content of [englishPlan, chinesePlan, englishRun, chineseRun, englishAccept, chineseAccept]) {
+    assert(content.includes('opentest/references/web-browser-testing.md'), '[WEB] plan/run/accept skills must read web-browser-testing reference');
+  }
+
+  assert(!allWebText.includes('MetaS'), '[WEB] Web testing assets must not mention MetaS');
+  assert(!allWebText.includes('android-midscene-pytest') && !allWebText.includes('@midscene/android') && !allWebText.includes('python -m pytest tests_py -v') && !allWebText.includes('ADB'), '[WEB] Web testing assets must not include Android-specific route text');
+}
+
+function assertDesktopGuiContracts() {
+  const manifestText = readFileSync('assets/manifest.json', 'utf8');
+  const englishSkill = readRequiredText('assets/skills/opentest-desktop-gui/SKILL.md', '[DESKTOP] missing English desktop GUI skill');
+  const chineseSkill = readRequiredText('assets/skills-zh/opentest-desktop-gui/SKILL.md', '[DESKTOP] missing Chinese desktop GUI skill');
+  const englishReference = readRequiredText('assets/skills/opentest/references/desktop-gui-testing.md', '[DESKTOP] missing English desktop GUI reference');
+  const chineseReference = readRequiredText('assets/skills-zh/opentest/references/desktop-gui-testing.md', '[DESKTOP] missing Chinese desktop GUI reference');
+  const englishTemplate = readRequiredText('assets/skills/opentest/templates/desktop-gui-acceptance-template.md', '[DESKTOP] missing English desktop GUI template');
+  const chineseTemplate = readRequiredText('assets/skills-zh/opentest/templates/desktop-gui-acceptance-template.md', '[DESKTOP] missing Chinese desktop GUI template');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishRun = readFileSync('assets/skills/opentest-run/SKILL.md', 'utf8');
+  const chineseRun = readFileSync('assets/skills-zh/opentest-run/SKILL.md', 'utf8');
+  const englishAccept = readFileSync('assets/skills/opentest-accept/SKILL.md', 'utf8');
+  const chineseAccept = readFileSync('assets/skills-zh/opentest-accept/SKILL.md', 'utf8');
+  const allDesktopText = [
+    englishSkill,
+    chineseSkill,
+    englishReference,
+    chineseReference,
+    englishTemplate,
+    chineseTemplate,
+  ].join('\n');
+
+  assert(manifestText.includes('opentest-desktop-gui/SKILL.md'), '[DESKTOP] manifest must ship opentest-desktop-gui skill');
+  assert(manifestText.includes('opentest/references/desktop-gui-testing.md'), '[DESKTOP] manifest must ship desktop GUI reference');
+  assert(manifestText.includes('opentest/templates/desktop-gui-acceptance-template.md'), '[DESKTOP] manifest must ship desktop GUI acceptance template');
+
+  assert(englishSkill.includes('@midscene/computer') && englishSkill.includes('project GUI automation') && englishSkill.includes('deterministic read-back'), '[DESKTOP] English desktop skill must route project automation and @midscene/computer');
+  assert(chineseSkill.includes('@midscene/computer') && chineseSkill.includes('项目 GUI 自动化') && chineseSkill.includes('确定性回读'), '[DESKTOP] Chinese desktop skill must route project automation and @midscene/computer');
+  assert(englishReference.includes('Windows RDP') && englishReference.includes('Do not mark `desktop-gui` acceptance as PASS from an AI visual assertion alone'), '[DESKTOP] English reference must include RDP and no-AI-only PASS rule');
+  assert(chineseReference.includes('Windows RDP') && chineseReference.includes('不得只凭 AI 视觉断言'), '[DESKTOP] Chinese reference must include RDP and no-AI-only PASS rule');
+  assert(englishTemplate.includes('tool route: project GUI automation | @midscene/computer') && englishTemplate.includes('reopen/restart check'), '[DESKTOP] English template must include route and read-back fields');
+  assert(chineseTemplate.includes('工具路线: 项目 GUI 自动化 | @midscene/computer') && chineseTemplate.includes('重开/重启检查'), '[DESKTOP] Chinese template must include route and read-back fields');
+
+  for (const content of [englishPlan, chinesePlan, englishRun, chineseRun, englishAccept, chineseAccept]) {
+    assert(content.includes('opentest/references/desktop-gui-testing.md'), '[DESKTOP] plan/run/accept skills must read desktop GUI reference');
+  }
+
+  assert(!allDesktopText.includes('@midscene/android') && !allDesktopText.includes('android-midscene-pytest') && !allDesktopText.includes('ADB smoke'), '[DESKTOP] Desktop GUI assets must not include Android-specific route text');
+}
+
+function assertApiContracts() {
+  const manifestText = readFileSync('assets/manifest.json', 'utf8');
+  const englishSkill = readRequiredText('assets/skills/opentest-api/SKILL.md', '[API] missing English API skill');
+  const chineseSkill = readRequiredText('assets/skills-zh/opentest-api/SKILL.md', '[API] missing Chinese API skill');
+  const englishReference = readRequiredText('assets/skills/opentest/references/api-testing.md', '[API] missing English API reference');
+  const chineseReference = readRequiredText('assets/skills-zh/opentest/references/api-testing.md', '[API] missing Chinese API reference');
+  const englishTemplate = readRequiredText('assets/skills/opentest/templates/api-acceptance-template.md', '[API] missing English API template');
+  const chineseTemplate = readRequiredText('assets/skills-zh/opentest/templates/api-acceptance-template.md', '[API] missing Chinese API template');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishRun = readFileSync('assets/skills/opentest-run/SKILL.md', 'utf8');
+  const chineseRun = readFileSync('assets/skills-zh/opentest-run/SKILL.md', 'utf8');
+  const englishAccept = readFileSync('assets/skills/opentest-accept/SKILL.md', 'utf8');
+  const chineseAccept = readFileSync('assets/skills-zh/opentest-accept/SKILL.md', 'utf8');
+  const allApiText = [
+    englishSkill,
+    chineseSkill,
+    englishReference,
+    chineseReference,
+    englishTemplate,
+    chineseTemplate,
+  ].join('\n');
+
+  assert(manifestText.includes('opentest-api/SKILL.md'), '[API] manifest must ship opentest-api skill');
+  assert(manifestText.includes('opentest/references/api-testing.md'), '[API] manifest must ship API reference');
+  assert(manifestText.includes('opentest/templates/api-acceptance-template.md'), '[API] manifest must ship API acceptance template');
+
+  assert(englishSkill.includes('pytest') && englishSkill.includes('httpx') && englishSkill.includes('jsonschema') && englishSkill.includes('read-after-write'), '[API] English API skill must route pytest/httpx/schema/read-after-write');
+  assert(chineseSkill.includes('pytest') && chineseSkill.includes('httpx') && chineseSkill.includes('jsonschema') && chineseSkill.includes('写后读'), '[API] Chinese API skill must route pytest/httpx/schema/read-after-write');
+  assert(englishReference.includes('Do not mark API acceptance as PASS from a 2xx response alone') && englishReference.includes('idempotency') && englishReference.includes('cleanup/teardown'), '[API] English reference must include no-2xx-only, idempotency, and cleanup rules');
+  assert(chineseReference.includes('不得只凭 2xx 响应') && chineseReference.includes('幂等') && chineseReference.includes('cleanup/teardown'), '[API] Chinese reference must include no-2xx-only, idempotency, and cleanup rules');
+  assert(englishTemplate.includes('tool route: project API command | pytest + httpx/requests') && englishTemplate.includes('Read-Back Contract'), '[API] English template must include route and read-back fields');
+  assert(chineseTemplate.includes('工具路线: 项目 API 命令 | pytest + httpx/requests') && chineseTemplate.includes('回读契约'), '[API] Chinese template must include route and read-back fields');
+
+  for (const content of [englishPlan, chinesePlan, englishRun, chineseRun, englishAccept, chineseAccept]) {
+    assert(content.includes('opentest/references/api-testing.md'), '[API] plan/run/accept skills must read API reference');
+  }
+
+  assert(!allApiText.includes('@midscene/android') && !allApiText.includes('@midscene/computer') && !allApiText.includes('Playwright MCP') && !allApiText.includes('ADB smoke'), '[API] API assets must not include GUI-specific route text');
+}
+
+function assertTestAssetLayoutContracts() {
+  const manifestText = readFileSync('assets/manifest.json', 'utf8');
+  const englishLayout = readRequiredText('assets/skills/opentest/references/test-asset-layout.md', '[LAYOUT] missing English test asset layout reference');
+  const chineseLayout = readRequiredText('assets/skills-zh/opentest/references/test-asset-layout.md', '[LAYOUT] missing Chinese test asset layout reference');
+  const englishWorkflow = readFileSync('assets/skills/opentest/references/complete-testing-workflow.md', 'utf8');
+  const chineseWorkflow = readFileSync('assets/skills-zh/opentest/references/complete-testing-workflow.md', 'utf8');
+  const englishSurfaces = readFileSync('assets/skills/opentest/references/test-surfaces.md', 'utf8');
+  const chineseSurfaces = readFileSync('assets/skills-zh/opentest/references/test-surfaces.md', 'utf8');
+  const englishApi = readFileSync('assets/skills/opentest/references/api-testing.md', 'utf8');
+  const chineseApi = readFileSync('assets/skills-zh/opentest/references/api-testing.md', 'utf8');
+  const englishWeb = readFileSync('assets/skills/opentest/references/web-browser-testing.md', 'utf8');
+  const chineseWeb = readFileSync('assets/skills-zh/opentest/references/web-browser-testing.md', 'utf8');
+  const englishDesktop = readFileSync('assets/skills/opentest/references/desktop-gui-testing.md', 'utf8');
+  const chineseDesktop = readFileSync('assets/skills-zh/opentest/references/desktop-gui-testing.md', 'utf8');
+  const englishPlan = readFileSync('assets/skills/opentest-plan/SKILL.md', 'utf8');
+  const chinesePlan = readFileSync('assets/skills-zh/opentest-plan/SKILL.md', 'utf8');
+  const englishAuthor = readFileSync('assets/skills/opentest-author/SKILL.md', 'utf8');
+  const chineseAuthor = readFileSync('assets/skills-zh/opentest-author/SKILL.md', 'utf8');
+  const englishRun = readFileSync('assets/skills/opentest-run/SKILL.md', 'utf8');
+  const chineseRun = readFileSync('assets/skills-zh/opentest-run/SKILL.md', 'utf8');
+
+  assert(manifestText.includes('opentest/references/test-asset-layout.md'), '[LAYOUT] manifest must ship test asset layout reference');
+  assert(englishLayout.includes('Option B') && englishLayout.includes('standard framework skeleton'), '[LAYOUT] English layout must define Option B as default');
+  assert(chineseLayout.includes('方案 B') && chineseLayout.includes('标准测试框架骨架'), '[LAYOUT] Chinese layout must define Option B as default');
+
+  for (const requiredPath of [
+    'tests/api/',
+    'tests/web/playwright/',
+    'tests/android/tests_py/',
+    'tests/desktop/midscene/',
+    'docs/opentest/acceptance/',
+    'scripts/opentest-run-api.ps1',
+    'scripts/opentest-run-web.ps1',
+    'scripts/opentest-run-android.ps1',
+    'scripts/opentest-run-desktop.ps1',
+  ]) {
+    assert(englishLayout.includes(requiredPath), `[LAYOUT] English layout missing ${requiredPath}`);
+    assert(chineseLayout.includes(requiredPath), `[LAYOUT] Chinese layout missing ${requiredPath}`);
+  }
+
+  for (const content of [englishPlan, chinesePlan, englishAuthor, chineseAuthor, englishRun, chineseRun]) {
+    assert(content.includes('opentest/references/test-asset-layout.md'), '[LAYOUT] plan/author/run must read test asset layout reference');
+  }
+
+  assert(englishWorkflow.includes('test-asset-layout.md') && chineseWorkflow.includes('test-asset-layout.md'), '[LAYOUT] workflow must require fixed asset layout');
+  assert(englishSurfaces.includes('do not invent directories') && chineseSurfaces.includes('不得在 author 时临场发明目录'), '[LAYOUT] test-surfaces must forbid ad hoc directories');
+  assert(englishApi.includes('tests/api/clients/') && chineseApi.includes('tests/api/clients/'), '[LAYOUT] API reference must pin client directory');
+  assert(englishWeb.includes('tests/web/playwright/') && chineseWeb.includes('tests/web/playwright/'), '[LAYOUT] web reference must pin Playwright directory');
+  assert(englishDesktop.includes('tests/desktop/midscene/') && chineseDesktop.includes('tests/desktop/midscene/'), '[LAYOUT] desktop reference must pin Midscene directory');
+}
+
 function assertCompleteTestingWorkflowContracts() {
   const stateScript = readFileSync('assets/skills/opentest/scripts/opentest-state.sh', 'utf8');
   const detectScript = readFileSync('assets/skills/opentest/scripts/opentest-detect.sh', 'utf8');
@@ -575,6 +877,12 @@ runManifestPathRelativitySelfCheck();
 assertManifestStructure();
 assertPrepublishGateCoversManifestAssets();
 assertDefaultPytestContracts();
+assertRequirementFirstAcceptanceContracts();
+assertTestSurfaceContracts();
+assertWebBrowserContracts();
+assertDesktopGuiContracts();
+assertApiContracts();
+assertTestAssetLayoutContracts();
 assertCompleteTestingWorkflowContracts();
 assertProgressiveDisclosureContracts();
 assertOpenTestSearchRootsCoverPlatforms();