在最小相关目录运行诊断。每条命令有不同职责：
| 命令 | 主要边界 | 会不会写 | 失败代表什么 |
|---|---|---|---|
arc dsl format <dir> --check | 格式漂移 | 不会 | source 会被重新格式化 |
arc dsl format <dir> --write | 格式规范化 | 会 | 命令无法安全格式化 source |
arc dsl lint <dir> | DSL 静态编写问题 | 不会 | 有 error 级 lint finding；warning 仍需审阅 |
arc dsl validate <dir> | 已解析 AUP/DSL 语义 | 不会 | source/configuration contract 无效 |
arc dsl generate <dir> --check | compatibility-artifact 漂移 | 不会 | 物化 output 会不同 |
arc dsl generate <dir> --write | 物化 compatibility artifact | 会 | 无法安全生成 output |
arc blocklet check <dir> | 合并 source 检查、存在时的 Content Space 与选定 profile 结构 | 不会 | 已声明 blocklet shape 不符合该 check |
dsl validate 扫描 AUP source 和 Web layout，包括 pages/**/layout.aup、对象级 content/**/layout.aup 与 layouts/*.aup。扫描通过不检查读者看到的视觉层次，也不检查所有 runtime target 行为。
一条简单的验收顺序
arc dsl lint .
arc dsl validate .
arc blocklet check .
arc blocklet build .
arc blocklet run .前四步建立逐步扩大的静态/build 证据。最后一条命令才让人或干净 acceptance agent 打开实际 URL、检查目标交互并记录观察结果。
i18n migration 是独立且范围很窄的维护操作。它不会自动翻译内容，也不能可靠解决每一种历史 locale 结构；应审阅其 diff，而不是把它当作通用 upgrade 命令。
source 生成细节见生成、lint 与迁移；Web 站点诊断分类仍是 target-specific 内容，不放在这份 AUP reference 中。