scopechk 是一个放置前检查工具,用于判断一个条目是否属于某个目标的现有范围,依据是该目标自身已写明的规则或既有成员的共同特征,而非外部偏好。它不设定或收窄任何工作范围,只提供建议,由人决定并执行移动。
用途
当条目倾向于落入某个“开放的家”(即看似可接收的目标)时,scopechk 依据目标已有的书面来源(README、AGENTS.md、CONTRIBUTING、目录结构、命名规则、安装界面、声明的受众等)或当前成员的共同特征,给出该条目相对于每个候选目标的放置判定。它不评估流行度、个人喜好或节省的工作量。
主要能力
- 对条目、条目携带的指针(如链接、单行引用)和每个候选目标分别给出判定。
- 从目标来源中提取标准并标注出处(文件与章节);来源沉默时,从当前成员推断标准并标注为推断,同时列出参考成员。
- 找出与条目最接近的现有成员并说明理由,若无成员可比,则指出该缺失本身作为不匹配的证据。
- 列出目标将承担的成本(新依赖、条目触达所有安装者、需遵守的公开承诺、维护负担等),以清单而非评分形式呈现。
- 检查可达性:列出条目指向的所有资源(仓库、路径、服务、账户、工具),确认目标用户能否访问;无法检查的标记为未验证。
- 输出五类判定:范围内(所有标准成立且可达性通过)、变更后范围内(指明具体变更并说明满足的标准)、拆分(指明各部分的归属)、范围外(指明合适归属并对其重新执行步骤2-5)、待所有者决定(说明问题及不同答案对应的判定)。
- 以“审批停止”结束,声明未移动、复制、重命名、注册或删除任何内容,由提问者决定最终去向。
使用方式
- 固定(Pin):命名条目、每个候选目标及请求的动作(添加、移动、提升、合并、上游)。分离条目携带的指针与其指向物,各自独立判定。若条目或目标无法读取,报告 MISS 并停止。
- 读取范围:从目标自身来源中记录每条标准及其位置;来源沉默时,从当前成员推断标准并标注。仅目标所有者能决定的标准成为所有者问题。
- 比较最近成员:选择服务同类用户或从事同类工作的现有成员,说明为何最近,并在每条标准上比较。无可比成员时说明,该缺失作为不匹配的证据。
- 列出目标承担的成本:新依赖、条目触达范围、公开承诺、维护负担等。
- 检查可达性:列出条目指向的所有资源,确认目标用户可访问;不可访问(如公开目标中的私有仓库、某机器上的路径)为失败;无法检查的标记未验证。
- 给出判定:每个条目、指针和目标各一个判定。
- 停止:以审批停止结束,列出各部分的拟定放置、所有者问题,并声明未做任何改动。
适用场景
- 在将代码、文档、配置等条目添加到某个仓库或项目之前,判断是否符合该项目范围。
- 在移动、提升、合并或上游条目之前,评估目标是否适合。
- 需要明确归属决策并避免范围蔓延的协作场景。
限制
- 仅提出建议,从不编辑、移动、复制、重命名、注册或删除条目或目标。
- 标准仅来自目标来源或标注为推断的当前成员特征;品味、作者意愿、流行度、星标、节省的工作量均不作为标准。
- 范围外是成功结果,需明确陈述并指明合适归属。
- 可达性失败或未解决的所有者问题会排除“范围内”判定;推断不能回答所有者问题。
- 无法读取的条目或目标直接报告 MISS 并停止。