用途
Restraint 是一个面向代码改动评审与实现的技能,核心目标是把每次变更削减到用户实际提出的需求,并清理所有“没人要求”的内容。它明确将“移除”定义为删除,而不是标记为“延后审查”。
主要能力
- 只构建需求本身:用户未要求的元素、选项或代码路径,除非需求本身依赖它才能工作,否则都视为问题。尚未发布的代码不承担向后兼容义务。未经用户批准的删减只是建议,不是实际编辑。
- 不添加需求之外的界面:不增加用户未请求的区块、徽章、计数、说明文字、页脚、按钮内图标、声音或装饰效果。例如每一行都加计数徽章对应规则
restraint-no-unrequested-ui。 - 不重复屏幕已有的反馈:如果操作结果已经显示在屏幕上,不再添加 toast 或对话框,对应规则
restraint-no-redundant-feedback。 - 采用最小可行实现:优先使用原生元素而非自定义元素,优先单应用而非 monorepo,优先固定值而非设置项。例如
<video controls>能满足时不用自定义视频播放器(restraint-smallest-build);没人会改的间距偏好应使用固定--gap(restraint-no-needless-setting)。 - 发布前不写防御性代码:未发布的工作中不保留遗留分支或兼容垫片(
restraint-no-legacy);对于总是有值的变量,不添加?? defaultValue之类的兜底(restraint-no-fallbacks)。 - 移除意味着删除:用户说移除时,删除代码及其样式、变量、路由和菜单项。把“延后审查”当作处理方式对应
restraint-delete-dont-defer;移除包后仍将其变量留在theme.css中对应restraint-remove-the-trail。若用户要求清理,则列出未使用的文件、导出、样式、依赖和遗留原型,批准后删除。 - 注释只陈述约束或删除:删除叙述代码的注释,仅保留代码本身无法表达的约束。叙述性注释对应
restraint-no-narrating-comments。 - 成对检查:每条规则都给出“错误写法”与“替代写法”的对照,便于在评审中逐条核对。
使用方式
该技能以规则编号(如 restraint-no-unrequested-ui)标记具体问题,在报告时按以下方式输出:
- 严重度:HIGH 表示用户未要求的功能、设置或代码路径,或“已移除”但仍存在的内容;MEDIUM 表示兜底、遗留分支或残留变量;LOW 表示叙述性注释。
- 格式:每条根因一条发现,格式为
file:line - [rule-id] what is wrong,随后给出 Rule | Count | Severity 汇总。 - 结论:只要存在任何 HIGH 问题就阻止通过(Block),否则批准(Approve)。未读过的文件不得批准;无法执行的检查标记为 Not verified。
适用场景
适合代码评审、整洁代码实践、减少过度工程与过度设计、清理未使用代码与依赖、约束界面添加范围等开发场景。
限制
该技能主要面向代码改动与界面实现的约束检查,资料未说明其支持的具体编程语言、框架、平台或集成方式;也未提供安装命令、收费模式或自动化执行细节,这些信息暂未提供。