关于 scope
scope 是用于审查拟议写入范围的建议型 Skill，会依据验收条件、生成文件和排除项推导路径，并指出缺口或歧义，不修改仓库状态。
主要功能
- 01将验收条件映射到源路径
- 02纳入生成的配套文件
- 03发现过宽或重叠的模式
- 04让路径模式对应明确公理
- 05规定按字节验证的恢复
适用场景
- 01审查拟议的变更边界
- 02查找遗漏或缺乏依据的路径
- 03规划已触碰受保护文件的恢复
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/scope确认已加载。
附带文件scripts/validate.sh
详细介绍
Scope — 审查拟议的写入范围
审查现有 bead 或调用方意图中的写入范围。此技能仅提供建议：不会创建第二份规划文档、写入锁、安装钩子、阻止编辑或认领路径。
输入
- 一个活跃行为及其验收场景。
- 拟议的包含和排除模式。
- 已知的生成伴随文件以及 fixture／投影路径。
- 明确的非目标。
流程
- 将每项验收标准映射到可能发生变更的最小源路径集合。
- 加入必须随这些源文件一同变更的自有生成伴随文件。
- 检查包含／排除模式是否重叠，或范围过宽而无法验证。
- 找出提案可能遗漏的路径。
- 返回修正后的提案及每项变更的理由，然后停止。
调用方决定是否在原始意图来源中采纳该提案；Validate 会独立比较运行时推导出的变更路径与该范围。
公理内核框架
从公理推导范围，而不是凭直觉罗列。说明验收所确立的少量事实——“行为 X 位于根目录 A”“投影 B 由 A 生成”“C 下的历史记录已冻结”——并确保每个包含和排除模式都恰好由一条公理推导。没有公理支持的模式属于无依据的扩张；没有对应模式的公理则代表缺口。两者都要写入审查结果。通过列出感觉上相关的目录来拼凑范围，是凭感觉划定边界这一失败模式：当 Validate 在边界处发现路径时，这种范围无法辩护，因为没人说得清边界为何划在那里。停止条件：当公理到模式的映射中，双方都不再有未映射项时，审查即告完成。
按字节验证的恢复流程
如果审查发现受保护路径已被改动，或调用方询问如何撤销范围违规，建议必须给出具体流程，而不能含糊带过：为每个受影响路径确定已知良好的来源（已提交状态、快照或由源文件生成），执行恢复，然后逐字节验证恢复后的内容与已知良好的字节一致（比较内容哈希，而非视觉差异或“看起来没问题”）。仅凭检查就宣布恢复完成，是目测恢复这一失败模式：文件看似已恢复，字节上仍可能存在重要差异。该流程的停止条件是每个受影响路径的哈希均匹配；任何没有已知良好来源可供比对的路径，都应报告为按当前范围无法恢复，由调用方决定。
输出
write_scope:
include: ["bounded/source/**"]
exclude: ["bounded/source/generated-by-other-owner/**"]
generated_companions: ["bounded/generated/**"]
gaps: []
ambiguities: []
检查项
- 模式均为规范化的仓库相对路径。
- 包含范围覆盖该行为，但不授予无关目录的权限。
- 排除项不会与必需变更相矛盾。
- 明确列出生成伴随文件。
- 不引入所有权、排期、Git、钩子、重试、发布或交付状态。
失败处理
如果无法根据提供的验收内容明确范围，则报告缺失事实并停止。调用方可以在新的操作中修订意图。