SuperAPI AI 工具集

no-broken-window

通用与其它

查看项目

更新于 10-16 01:17

技能介绍

用途:当用户提出希望统一某条规则、模式或约定时,该技能帮助扫描代码库现状、确立可执行的规则并加以强制,避免“破窗效应”导致标准被逐步侵蚀。

主要能力:

  1. 识别模式:把规则浓缩为一句话,扫描代码库找出既有违规,报告合规与违规数量及确切边界。
  2. 协作制定标准:用具体示例提出规则(允许什么、不允许什么),与用户一起解决灰色地带,写成单条可执行陈述。
  3. 强制执行:按优先级尝试落地——优先 Lint 规则(ESLint、Biome 等,开发时捕获);其次 pre-commit 钩子(提交时捕获);再次 CI 检查(如 GitHub Action,PR 时捕获);无法自动化时仅写入文档。每种方案先起草规则/脚本/配置,展示能捕获与放行的内容,经用户确认后再应用,并修复既有违规或创建跟踪 issue。
  4. 文档化:将规则加入 CONTEXT.md 的“Conventions”章节(不存在则创建);若涉及真实取舍,可提供 ADR。

关键原则:一条规则一句话,说不清就太模糊;不自动化就会腐化,没有 linter 的规则只是建议;先清理既有违规或建立跟踪 issue;灰色地带是规则本身的缺陷,需进一步明确。

限制:资料未提供具体安装命令、支持平台范围、收费方式或效果保证;实际执行依赖用户确认与项目现有工具链。