用途：对 Swift 项目执行代码规范门禁并诊断结果，适用于用户要求 lint、格式检查、自动修复、提交前质量验证，或出现 swiftlint 相关失败时。核心是把“看起来没问题”变成可重复的工具证据，并诚实区分通过、失败、无法验证与 planned。
主要能力：根据 .swift 与 Package.swift 等项目标记识别 Swift 工作区；执行 swiftlint 并保留退出码、作用域与工具版本；把失败分为格式、静态规则、配置、环境、工具内部错误五类；用 swiftlint --fix 处理可逆问题并复扫；将本地结果与 CI/构建/测试证据分层汇报。
用法要点：在仓库根确认 Package.swift 或目标文件存在；探测工具 swiftlint --version（安装方式 brew install swiftlint）；先只读执行 swiftlint；仅对可安全修复项执行 swiftlint --fix；修复后必须复跑触发失败的原命令，并运行项目已有测试与构建。项目若已有配置以已提交配置为准，示例与仓库配置冲突时先报告差异。多模块项目先列出将扫描的模块，不靠当前目录猜测。
适用场景：AI 修改 .swift 后的提交前验证；CI 中出现 swiftlint 相关失败；判断某问题能否自动修复或必须人工处理。
限制：目标工具必须已安装且版本兼容，并须从正确仓库或模块根目录执行；工具缺失、版本不兼容或配置无法加载均记为“无法验证”，不是通过。不把 formatter 通过当作编译、测试或安全审计通过；不静默安装工具、升级依赖或修改团队规则；不用 suppress、ignore 或调高阈值掩盖问题；自动修复前先审查 diff，破坏性或大范围修改需用户明确确认。不适用于语言语法、框架设计、业务建模学习，以及依赖漏洞、安全审计和许可证治理。本技能不收集、上传或存储用户代码与凭据，默认只读取本地仓库配置并运行本地工具。