SuperAPI AI 工具集

linting-alignment

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

Linting Alignment 是一个用于对齐代码检查与格式化工具链的智能体技能,来源为 christofferbergj/agent-skills。

用途 该技能用于在仓库中审查、对齐或发布 lint 与格式化工具链的配置。它强调“仓库策略优先”:在尽量贴近当前上游行为的前提下,保留那些仍然保护真实项目约束的本地规则。它把配置视为一张可执行的归属关系图,而不是一份熟悉的包名清单。

主要能力 技能根据请求推断授权模式:

  • Review:检查并报告,保持工作区不变。
  • Align:检查、做聚焦修改并验证。当用户要求更新、修复、迁移或配置工具链时,这是默认模式。
  • Publish:先对齐,然后仅在用户明确要求该边界时提交、推送或发起评审。

技能的工作流程分为八个步骤:

  1. 建立仓库权威:解析仓库根目录、活动分支、工作区状态和适用的根级与作用域级智能体指令,读取治理受影响范围的代码风格、贡献、依赖、生成文件和验证指南。
  2. 构建归属关系图:通过可执行关系清点 lint 表面,包括包清单、锁文件、工作区声明、脚本、根级与嵌套配置、导入、extends、插件声明、CLI 调用、生成文件、内联禁用等,并记录每个节点的角色与归属。
  3. 建立可比基线:在对齐编辑前,运行仓库批准的最小只读命令,覆盖范围内每条活动通道,记录命令、版本、退出码、诊断数量或类别以及代表性有效配置。
  4. 验证归属层:检查已安装的 preset 与包源码,升级或迁移时还检查发布说明、迁移指南、包清单和官方文档。
  5. 决定本地取舍:将每个本地 preset 层、规则覆盖、插件、嵌套配置、忽略模式、抑制、重复命令和非默认格式化选项分类为保留、移除、收窄、源修复、迁移或推迟。
  6. 先探测再应用:一次探测一个归属边或规则组,并重跑其聚焦基线命令。
  7. 比较与验证:用相同范围和环境重跑完全相同的基线探测,逐通道比较有效配置、退出状态、诊断、格式化输出和相关运行时成本。
  8. 按请求边界报告:以结果开头,总结归属关系图、直接有依据的变更、保留的重要本地策略、基线比较、验证结果、搁置或推迟的工作以及任何来源或比较缺口。

使用方式 该技能以智能体技能形式提供,通过自然语言请求触发。用户可要求审查共享配置、升级或迁移 linter、formatter、preset、analyzer 或类型感知检查。技能会根据请求推断 Review、Align 或 Publish 模式。具体安装命令与调用方式在提供的资料中暂未说明。

适用场景

  • 审查共享的 lint 与格式化配置。
  • 升级或迁移 linter、formatter、preset、analyzer 或类型感知检查。
  • 对齐仓库中的 lint 与格式化工具链。
  • 在涉及 Ultracite、Oxlint、Oxfmt 或其集成时,需先完整阅读 references/ultracite-oxc-ownership.md 再判断配置是否冗余。
  • 在涉及 React Doctor 或其集成时,需先完整阅读 references/react-doctor-ownership.md 再比较其 analyzer 与 plugin 通道。

限制 资料中未提供该技能的具体安装命令、支持的平台、收费或价格信息、实际效果数据以及使用步骤示例。技能强调不得在没有比较的情况下把诊断称为回归,不得把不可用的基线称为回归,也不得把插件、analyzer 和类型感知通道误认为可相互替代。