关于 scope
用于确保编辑符合用户要求并保留现有行为的审查技能,涵盖明确范围、逐项跟踪请求、遵循先前指示及检查附带改动。
主要功能
- 01将改动限定在指定目标
- 02逐项跟踪并报告请求
- 03沿用先前指示与给定值
- 04重构时保留现有功能
- 05区分规划与实际修改
适用场景
- 01审查范围明确的界面改动
- 02处理包含多个事项的请求
- 03检查重构是否丢失原有行为
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ raphaelsalaja/ skills --skill scope安装后在 Claude Code 中输入/scope确认已加载。
附带文件agents/openai.yaml
详细介绍
范围
此技能会对请求进行编辑。它会按最狭义的字面含义理解请求,保留所有原本有效的内容,并逐项处理用户提出的内容。
以最狭义的理解为准
除非用户要求全面检查,否则对未点名元素的改动都算一项问题。在进行大范围改动前先简短提问,不算问题。对只指向一个元素的简短消息、批量消息和重构,要格外谨慎。
删除用户未要求删除的内容属于 restraint。证明改动有效属于 verify。
每项请求都要有答复
将消息拆分为带编号的条目,并加入此前对话中尚未解决的条目。最后用同一份清单逐项说明已完成或未完成,并给出原因。只完成四项请求中的第一项,属于 scope-list-every-ask。
只改点名的元素,不动周边内容
用几个词重述目标。“卡片”指卡片,而不是卡片周围的页面。用户要求修改顶栏,却重新设计整个外壳,属于 scope-smallest-reading。如果有两种合理解读,就简短提问一次。
之前的指示仍然有效
编辑之前,阅读用户在当前对话中先前提出的更正,以及仓库中的规则。把用户删除的内容重新加回来,属于 scope-remember-instructions。用户给出的值,例如 16px 的左侧内边距,必须保留。擅自猜测新值,属于 scope-keep-given-values。
保留所有有效内容
重构前,列出当前已有的功能、按钮和状态,之后逐项检查。删掉返回按钮,属于 scope-keep-what-worked。修复一个属性时,其他属性也要保留。为修复裁剪问题而移除宽度动画,属于 scope-no-collateral。
未发布的工作现在就要完成
未经询问,不得把尚未发布的工作拆分成多个阶段,也不得标记为范围外。列出“第二阶段”的内容,属于 scope-no-phasing。规划时只做规划。计划获批前编辑文件,属于 scope-plan-means-plan。
解释本身就是答案
用户询问某项功能如何工作时,应解释并等待。用户问“这是怎么工作的”,却用差异来回答,属于 scope-explain-when-asked。
对照项
每项检查都要成对呈现。出问题的代码行要与替换它的代码行并列。
| 规则 | 问题示例 | 替换方案 |
|---|---|---|
scope-list-every-ask | 四项请求只完成第一项,其余三项遗漏 | 列出四个编号条目,并逐项报告 |
scope-smallest-reading | “修复顶栏”却重新设计整个外壳 | 只修改顶栏 |
scope-remember-instructions | 用户删除的圆点又被加了回来 | 编辑前阅读之前的对话 |
scope-keep-given-values | 将左侧内边距重新猜为 12px | 保留用户指定的 16px |
scope-keep-what-worked | 重构后移除了前进和后退按钮 | 列出改动前后的功能,并保留两个按钮 |
scope-no-collateral | 修复了裁剪问题,却移除了宽度动画 | 修复裁剪问题,同时保留宽度动画 |
scope-no-phasing | “已保存的筛选器:第二阶段” | 立即构建,或提问一次 |
scope-plan-means-plan | 规划期间编辑文件 | 计划获批前只做规划 |
scope-explain-when-asked | 用户要求“解释它如何工作”,却用差异来回答 | 先解释,然后等待 |
报告
严重程度。 HIGH 表示功能被移除,或先前的指示被撤销。MEDIUM 表示改动超出点名元素的范围,或请求未报告。LOW 表示本来有明确的一种理解,却仍然提出了问题。
格式。 每个根本原因写一项发现;没有适用文件时,引用用户的请求:
file:line - [rule-id] what is wrong
request 2 - [rule-id] what is wrong
然后给出 Rule | Count | Severity 汇总。只要仍有 HIGH,就标记为 Block;否则标记为 Approve。不得对未阅读的差异标记 Approve。将所有未能运行的检查标记为 Not verified。