SuperAPI AI 工具集

restraint

编程与开发

查看项目

更新于 11-06 16:15

技能介绍

用途

Restraint 是一个面向代码改动评审与实现的技能,核心目标是把每次变更削减到用户实际提出的需求,并清理所有“没人要求”的内容。它明确将“移除”定义为删除,而不是标记为“延后审查”。

主要能力

  1. 只构建需求本身:用户未要求的元素、选项或代码路径,除非需求本身依赖它才能工作,否则都视为问题。尚未发布的代码不承担向后兼容义务。未经用户批准的删减只是建议,不是实际编辑。
  2. 不添加需求之外的界面:不增加用户未请求的区块、徽章、计数、说明文字、页脚、按钮内图标、声音或装饰效果。例如每一行都加计数徽章对应规则 restraint-no-unrequested-ui。
  3. 不重复屏幕已有的反馈:如果操作结果已经显示在屏幕上,不再添加 toast 或对话框,对应规则 restraint-no-redundant-feedback。
  4. 采用最小可行实现:优先使用原生元素而非自定义元素,优先单应用而非 monorepo,优先固定值而非设置项。例如 <video controls> 能满足时不用自定义视频播放器(restraint-smallest-build);没人会改的间距偏好应使用固定 --gap(restraint-no-needless-setting)。
  5. 发布前不写防御性代码:未发布的工作中不保留遗留分支或兼容垫片(restraint-no-legacy);对于总是有值的变量,不添加 ?? defaultValue 之类的兜底(restraint-no-fallbacks)。
  6. 移除意味着删除:用户说移除时,删除代码及其样式、变量、路由和菜单项。把“延后审查”当作处理方式对应 restraint-delete-dont-defer;移除包后仍将其变量留在 theme.css 中对应 restraint-remove-the-trail。若用户要求清理,则列出未使用的文件、导出、样式、依赖和遗留原型,批准后删除。
  7. 注释只陈述约束或删除:删除叙述代码的注释,仅保留代码本身无法表达的约束。叙述性注释对应 restraint-no-narrating-comments。
  8. 成对检查:每条规则都给出“错误写法”与“替代写法”的对照,便于在评审中逐条核对。

使用方式

该技能以规则编号(如 restraint-no-unrequested-ui)标记具体问题,在报告时按以下方式输出:

  • 严重度:HIGH 表示用户未要求的功能、设置或代码路径,或“已移除”但仍存在的内容;MEDIUM 表示兜底、遗留分支或残留变量;LOW 表示叙述性注释。
  • 格式:每条根因一条发现,格式为 file:line - [rule-id] what is wrong,随后给出 Rule | Count | Severity 汇总。
  • 结论:只要存在任何 HIGH 问题就阻止通过(Block),否则批准(Approve)。未读过的文件不得批准;无法执行的检查标记为 Not verified。

适用场景

适合代码评审、整洁代码实践、减少过度工程与过度设计、清理未使用代码与依赖、约束界面添加范围等开发场景。

限制

该技能主要面向代码改动与界面实现的约束检查,资料未说明其支持的具体编程语言、框架、平台或集成方式;也未提供安装命令、收费模式或自动化执行细节,这些信息暂未提供。