关于 scopechk
scopechk 是用于判断某项内容是否符合候选目标现有范围的技能,依据目标文档和现有成员进行比较。它只提出放置建议,由人工决定,不会修改内容或目标。
主要功能
- 01依据目标来源提取范围标准
- 02与最接近的现有成员比较
- 03列出依赖项与维护负担
- 04检查指针的可达性
- 05给出 verdict 并等待审批
适用场景
- 01审查拟加入仓库的内容
- 02评估项目间的迁移或合并
- 03检查链接资源是否可访问
- 04区分应归属不同位置的内容
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill scopechk安装后在 Claude Code 中输入/scopechk确认已加载。
附带文件agents/openai.yaml
详细介绍
在某个条目进入目标范围之前,先检查它是否属于该目标现有的范围。
目标
某个条目往往会进入当下开放的归属地,一旦进入,就会被视为该归属地约定的一部分。scopechk 会根据每个候选目标对自身的现有说明,为某个条目给出归属判定:依据目标已有的书面资料,或在这些资料未作说明时,依据其现有成员的共同特征。它会对照已存在的范围检查条目,绝不设定或缩小某项工作的范围。它只提出建议;由人来决定和移置。
工作流
- 确定对象。 列出条目、每个候选目标,以及请求执行的操作(添加、移动、提升、合并、上游)。将条目附带的任何指向信息(链接、一行引用)与它指向的内容分开;两者分别给出判定。如果无法读取条目或某个目标,就为其报告
MISS,并在此处停止。 - 读取范围。 根据目标自身的资料(README、AGENTS.md、CONTRIBUTING、目录结构、命名规则、安装方式、目标受众)记录每项标准及其所在文件和章节。若资料没有说明,则根据现有成员的共同特征推断标准,标记为
inferred,并列出这些成员。只有目标负责人才能决定的标准,应作为负责人问题提出。 - 比较最接近的成员。 选出一个面向相同类型用户或执行相同类型工作的现有成员,并说明它为何最接近。针对每项标准,将条目与其进行比较。如果没有可比较的成员,请明确说明;这一缺失本身就是不适配的依据。
- 列出目标将承担的事项。 列出清单,而不是打分:新增依赖;该条目会触达每个安装或克隆目标的人;它将带来的每项公开承诺(稳定的安装方式、发布节奏、公开接口);以及新增的维护工作。
- 检查可访问性。 列出条目指向的所有内容(仓库、路径、服务、账户、工具),并通过实际打开,或查看其可见性,确认目标用户能否访问每一项。用户无法访问的内容(例如,公开目标中的私有仓库,或某台机器上的路径)都属于失败。无法检查的内容标记为
unverified,并注明具体内容。 - 给出判定, 对每个条目、指向信息和目标分别作出判定:
in scope:所有标准均符合,且可访问性检查通过;in scope after change:明确提出要做的具体变更(删去一行、替换某个路径、移除某项依赖),以及该变更满足的标准;split:列出各个部分及其归属地;out of scope:指出适配的归属地,并在该归属地上执行步骤 2 至 5;pending owner:某个尚待回答的负责人问题会决定判定结果;说明问题,并说明每种回答对应的判定。
- 停止。 以
Approval stop结束:列出各个部分建议的归属地、任何负责人问题,并声明没有移动、复制、重命名、注册或删除任何内容。由提出请求的人决定是否将其放入某处,以及放在哪里。
规则
- 标准只能来自目标的资料,或来自标记为
inferred的现有成员。品味、作者意愿、受欢迎程度、星标数和节省的工作量都不能作为标准。 out of scope是成功的结果。应直截了当地说明,并指出适配的归属地。- 可访问性检查失败或存在未解决的负责人问题,都不能判为
in scope;推断不能代替负责人回答问题。 - 只提出建议。在执行过程中绝不编辑、移动、复制、重命名、注册或删除条目或目标。
验证
- 每项标准都注明其在目标资料中的位置,或标记为
inferred并列出其来源成员。 - 指出最接近的成员并说明其最接近的原因,或明确说明不存在此类成员。
- 每项指向信息都经过可访问性检查,或标记为
unverified;in scope判定中不得存在检查失败。 - 除
in scope外的每项判定,都要说明相应变更、归属地或负责人问题。 - 流程以审批停止结束,且没有任何内容被移动。
评论
支持 Markdown