Scope Sentinel

“最昂贵的一行代码，是你本不必写的那一行；最昂贵的一次重构，是你‘顺手’开始的那一次。”

它做什么

你坐下来修复结账流程中的一个 Bug。两小时后，你已重新格式化了 auth 模块、为三个工具文件添加了类型、重命名了一个数据库字段，并升级了一个依赖。而那个 Bug？依然存在。

Scope Sentinel 持续观察你 实际在做的事，并与你 声明要做的事 进行比对。当二者偏差过大时，它会介入——不是为了阻止你，而是让这种偏离变得 可见，从而让你能主动做出选择。

偏离模型（Drift Model）

范围定义（Scope Definition）

在任务启动之初，你的工作范围由以下要素界定：

SCOPE ANCHOR:
├── Task statement: "Fix checkout failing for international addresses"
├── Target files: src/checkout/address.ts, src/checkout/validation.ts
├── Target behavior: International addresses should pass validation
├── Branch name: fix/international-address-checkout
└── Estimated files to touch: 2-4

偏离检测（Drift Detection）

你在开发过程中对每个文件的修改都会被分类：

偏离梯度（The Drift Gradient）

ON-SCOPE ──── ADJACENT ──── TANGENTIAL ──── DRIFT ──── RABBIT HOLE
   ✓              ✓             ⚠             🔴           🕳️
 "这是         "这是         "这和        "这是       "现在是
  修复"       修复的一      主要任务      另一个       哪一年？
               部分"       相关但非     任务"
                            核心部分"

它如何工作

Phase 1: ANCHOR
├── 捕获任务描述（来自分支名、提交信息或显式声明）
├── 识别代码库中目标影响区域
├── 确立范围边界（涉及的文件、模块、行为）
└── 设定偏离容忍度（tight / normal / exploratory）

Phase 2: MONITOR
├── 对每次文件修改进行分类：
│   ├── 此文件是否属于目标区域？
│   ├── 此修改是否关联所声明的任务？
│   ├── 此修改是否为任务成功所必需？
│   └── 此修改是否适合作为独立提交 / PR？
├── 跟踪累计偏离：
│   ├── 范围外修改的文件数
│   ├── 范围外修改的代码行数
│   └── 在范围外花费的时间
└── 跟踪范围扩展事件（当你发现任务实际比预期更复杂时）

Phase 3: ALERT
├── 当偏离累积超过阈值时：
│   ├── 明确指出偏离（“你已开始重构 auth —— 这与 checkout 无关”）
│   ├── 量化偏离（“4 个文件、87 行代码、约 25 分钟的范围外工作”）
│   ├── 提供选项：
│   │   ├── STASH：暂存范围外变更，留待后续单独处理
│   │   ├── COMMIT SEPARATELY：为范围外工作创建独立提交
│   │   ├── EXPAND SCOPE：承认范围扩大（需提供理由）
│   │   └── CONTINUE：你已知悉并主动选择继续
│   └── 记录本次决策，供后续审查
└── 若范围已扩展，则以更新后的范围继续监控

Phase 4: SESSION SUMMARY
├── 会话结束时生成报告：
│   ├── 范围内耗时 vs. 偏离耗时
│   ├── 范围内修改文件 vs. 范围外修改文件
│   ├── 偏离事件及其处理方式
│   └── 针对范围外发现提出的后续任务建议

告警格式

╔══════════════════════════════════════════════════════════════╗
║              SCOPE SENTINEL: DRIFT DETECTED                 ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  YOUR TASK: Fix checkout for international addresses         ║
║                                                              ║
║  DRIFT:                                                      ║
║  You've been modifying src/auth/middleware.ts for 18 minutes.║
║  This file is not related to checkout or address validation. ║
║                                                              ║
║  HOW YOU GOT HERE:                                           ║
║  checkout/address.ts → noticed untyped import                ║
║  → opened utils/types.ts to add types                        ║
║  → noticed auth/middleware.ts also uses these types           ║
║  → started "fixing" auth types too                           ║
║                                                              ║
║  ACCUMULATED OFF-SCOPE:                                      ║
║  ├── 3 files outside checkout/                               ║
║  ├── 47 lines of changes unrelated to the bug                ║
║  └── ~18 minutes of drift                                    ║
║                                                              ║
║  OPTIONS:                                                    ║
║  [1] STASH off-scope changes, return to checkout bug         ║
║  [2] COMMIT SEPARATELY ("add types to auth middleware")      ║
║  [3] EXPAND SCOPE (justify: "types are prerequisite")        ║
║  [4] CONTINUE (I know, I'll wrap up soon)                    ║
╚══════════════════════════════════════════════════════════════╝

会话总结

╔══════════════════════════════════════════════════════════════╗
║                SCOPE SENTINEL: SESSION REPORT                ║
║            Task: Fix international address checkout          ║
║            Duration: 2h 14m                                  ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  FOCUS SCORE: 68/100                                         ║
║                                                              ║
║  TIME BREAKDOWN:                                             ║
║  ├── On-scope:   1h 22m (62%)  ████████████░░░░░░░░         ║
║  ├── Adjacent:      18m (13%)  ██░░░░░░░░░░░░░░░░░░         ║
║  ├── Tangential:    16m (12%)  ██░░░░░░░░░░░░░░░░░░         ║
║  └── Drift:         18m (13%)  ██░░░░░░░░░░░░░░░░░░         ║
║                                                              ║
║  DRIFT EVENTS: 2                                             ║
║  ├── Auth middleware typing (stashed → separate task)        ║
║  └── Utility function rename (committed separately)          ║
║                                                              ║
║  FOLLOW-UP TASKS GENERATED:                                  ║
║  ├── "Add TypeScript types to auth middleware"                ║
║  └── "Rename formatAddress → formatPostalAddress globally"   ║
║                                                              ║
║  TASK STATUS: Bug fixed. PR ready.                           ║
╚══════════════════════════════════════════════════════════════╝

偏离容忍模式

何时启用

• 每次进入专注任务前。 设置你的范围锚点（Scope Anchor）。
• 处理 Bug 修复时（此时范围偏离代价最高）
• 在截止日期压力下工作时（每一分偏离时间都在损耗交付能力）
• 当你发现自己说出“while I'm in here...”时（经典的偏离信号短语）
• 准备代码审查（Code Review）前（确保 PR 聚焦明确）

为何重要

范围偏离（Scope drift）并非懒惰所致——它是开发者思维模式的自然产物。你发现问题，就想立刻修复它；这种冲动本身具有生产力。但若不加约束，一个原本只需 30 分钟的 Bug 修复，可能演变为耗时 4 小时、修改 15 个文件、难以评审的 PR。

Scope Sentinel 并不会阻止你做额外工作。它只确保这些额外工作是 有意为之，而非无意识发生。

零外部依赖。零 API 调用。纯文件变更监控。