用途：在 ArkTS（HarmonyOS）项目中识别 .ets 文件与代码规范检查意图，明确当前 Codeguard 支持状态与缺口，为未来接入定义可验证的验收条件。
主要能力：识别 ArkTS 文件和相关用户意图；报告支持状态；在具备真实工具输出、失败样例与通过样例、可重复非交互命令时推进接入。当前状态为 planned（自 Codeguard V0.5），文件扩展名 .ets，无专用标记文件，接入配置以仓库现有配置为准，无独立 CLI linter，lint、format/fix、项目级 gate 均未接入。
使用方式：先确认仓库根、模块根、生成目录、vendor 目录与用户指定文件；读取仓库现有配置及 CI 实际命令；运行对应工具 --version 探测版本；执行只读检查并记录命令、工作目录、退出码、工具版本与首个可操作错误；按格式、静态规则、配置、环境、工具内部错误分型；受控修复后复跑同一命令并运行已有测试与构建。输出模板包含范围、工具、命令、状态（PASS/FAIL/UNVERIFIED/PLANNED）、发现、修改、复验、未验证。
适用场景：用户要求检查或修复 ArkTS 代码规范；AI 修改 .ets 后需提交前验证；CI 出现与 ArkTS 工具链相关失败；判断问题能否自动修复。
限制：不执行不存在的通用 linter 命令，不把扩展名识别写成质量门禁通过，不在无运行证据时升级支持状态；工具缺失记为 UNVERIFIED 而非通过；formatter 不能覆盖静态规则或编译错误；不自动添加 ignore 或 suppression；不联网安装依赖，不收集上传代码与凭据；破坏性或大范围修改须用户明确确认。信息不足时先给出安全只读检查方案，并列出需确认的仓库根、目标工具版本、配置文件、CI 权威命令与是否允许自动修复。