诊断与验证

适用范围：Legacy Admin Kit / Schema 与旧 admin-vue。新 admin-nuxtui 的开发入口见管理端 Nuxt UI 指南。

验证归现有 package 和宿主 owner；Authoring Guide 只帮助选择最小验证面，不创建平行 CI。

环境与事实

Set-Location .\packages\yoyo-admin
pnpm run cli -- admin doctor --json
pnpm run cli -- admin capabilities --json
pnpm run cli -- admin contracts status --json

需要全部 owner current 时使用 contracts status --check --json。本地未启动 Web.Host 时，live OpenAPI 可以明确显示 unavailable；这不等于伪造通过。

按变化选择验证

变化	最小 owner 验证
CLI command/generator	在 tools/yoyoboot-cli 执行 pnpm run package:verify
Admin Schema contract/compiler	在 packages/yoyo-admin/admin-schema 执行 pnpm run package:verify
新增或修改 Page Schema	Admin Vue typecheck + check:schema-project + 目标 page conformance
Feature binding/extension	对应 focused Vitest + Admin Vue typecheck
Admin Kit/Data Workbench production runtime	Admin Kit focused tests；修改公共包时运行其 package:verify
Authoring 文档/Portal	authoring docs intent test + VitePress docs:build

Page Schema 检查

Push-Location ..\..\apps\yoyo-admin\admin-vue
pnpm run typecheck
pnpm run check:schema-project
pnpm run test:conformance -- --page <formal-page-key>
Pop-Location

Project check 负责 canonical schema source、registry/linking 与 legacy exception；conformance 验证公开契约行为。单纯构建成功不能代替缺失的 linking 或业务运行证据。

Capability gap 报告

当 capabilities --json 没有需要的 recipe，记录：缺少的作者场景、两个以上可统一 consumer 是否存在、现有 public contract 如何完成、是否需要新的 owner change。不要把人工实现伪装成 CLI 生成结果。