用途:对 Liquid(Shopify)项目执行代码规范门禁,把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或出现 theme-check . 相关失败时。
主要能力:根据 .liquid 与项目标记识别工作区;执行 theme-check . 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖和环境类失败;对可逆问题做人工最小修复并复扫;把本地结果与 CI/构建/测试证据分层汇报。
使用方式:在仓库根确认目标文件存在;探测工具 theme-check --version;先只读检查 theme-check .;将结果分为代码违规、配置缺失、工具缺失、工具内部错误;只对可安全修复项做最小修复;复跑 lint 并执行项目已有测试/构建门禁。工具准备命令为 gem install theme-check。
适用场景:检查或修复 Liquid(Shopify)代码规范;AI 修改 .liquid 后提交前验证;CI 出现 theme-check . 相关失败;判断问题能否自动修复或需人工处理。
限制:不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;缺少工具或配置时不得声称检查通过。工具缺失、版本不兼容或配置无法加载均记为“无法验证”。不适用于学习语言语法、框架设计、业务建模,以及依赖漏洞、安全审计或许可证治理。本技能不收集、上传、发送或存储用户代码和凭据,默认只读取本地仓库配置并运行本地工具,不联网安装依赖。