mcpField
S
scope

scope

github.com/raphaelsalajaAgent 工作流6295 次安装4 天前更新
代码仓库

关于 scope

用于确保编辑符合用户要求并保留现有行为的审查技能,涵盖明确范围、逐项跟踪请求、遵循先前指示及检查附带改动。

主要功能

  1. 01将改动限定在指定目标
  2. 02逐项跟踪并报告请求
  3. 03沿用先前指示与给定值
  4. 04重构时保留现有功能
  5. 05区分规划与实际修改

适用场景

  1. 01审查范围明确的界面改动
  2. 02处理包含多个事项的请求
  3. 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。

评论

支持 Markdown