Skip to content

feat(DEC-020-α): 门 2 判据从「本会话出现过」改成「时序」—— 它不再是一个永不失败的检查 - #79

Merged
heweidong-ecco merged 1 commit into
mainfrom
feat/dec020-alpha-skill-gate-timing
Sep 24, 2026
Merged

heweidong-ecco merged 1 commit into
mainfrom
feat/dec020-alpha-skill-gate-timing

Conversation

@heweidong-ecco

Copy link
Copy Markdown
Owner

实施 DEC-020 的 α(业务方 2026-09-24 签核 D-29)。

原判据的洞

grep -q 'test-driven-development' latest.json —— 读的是会话累计的 skills 字段
⇒ 开头调一次,之后本会话所有提交永久满足。

实测(2026-09-15 那场):TDD 只早期调 1 次,之后 4 个编码任务(含改判分器输入契约的 A2)
一次没调 —— 而这道门全程一次没响过。它退化成「一个永远不失败的检查」,
而它比没有门更坏:让下游(锚点/复盘/签核)相信"这里有结构兜着"。

新判据(第三版;前两版都被实跑证伪,过程记在工具 docstring)

取 lo = 上一次 git commit 的时刻(转录里它是 Bash 调用);
通过 ⟺ 存在 TDD 调用落在 (lo, 本次最早那次实现编辑]。
人话:自上次提交以来、动手之前,调过 TDD。

为什么不是"本轮":第二版拿「最近的那条 type:"user" 行」当回合起点 —— 实测证伪:
转录里 type:"user" 的行① 混着工具结果;② 真用户消息的时间戳与工具调用
互相穿插(同一次 Skill 调用 .556 vs 用户行 .604/.605)⇒ 窗口被压成 49 毫秒
⇒ 一律误拦 —— 本次改动自己的提交就被它拦下过。

第三版顺手堵了一个洞:用"最早那次编辑"会被上一段工作的编辑污染
(同一文件跨两次提交 ⇒ 放行);git commit 才是"上一段工作结束"的真实边界。

⚠️ 认下的边界(不得复述成"没问题")

  • 判不了 ⇒ 不阻断(打印 undecidable)—— 误拦是守卫被关掉的头号原因;
    代价:这条路径可被利用,所以它每次都会出声,不当成"通过";
  • 同一件工作分多次提交时可能被拦 ⇒ 用 [no-skill: <理由>] 豁免(D-29 预登记)。

交付

  • 新 tools/check_skill_before_edit.py + tests/test_skill_gate_timing.py(10 条);
  • .githooks/commit-msg 的门 2 改为调它(不再 grep 累计字段);
  • 改造 tests/test_hooks.py 两条既有用例:按新契约补合成转录,不是放宽断言。

验证(含真机)

  • 三条红测试各自先看红;期间修过两处我自己的测试 bug(辅助函数没建目录 ⇒ 报错而非失败);
  • ★ 真机验证:拿本会话真实转录跑 —— 第二版拦下了我自己的提交,第三版 exit 0;
    并且这次 commit 本身就在真实门 2 上跑过并通过;
  • 突变验证两条:a 忽略"上次提交"这个锚 ⇒ 2 条红 ✅ · b 忽略"动手之前" ⇒ 5 条红 ✅;
    还原 diff -q 逐字一致、MUTANT 残留 0;
  • 584 passed / 2 skipped(基线 574,+10)。

实施 `DEC-020` 的 α(业务方 2026-09-24 签核 **D-29**)。

## 原判据的洞

`grep -q 'test-driven-development' latest.json` —— 读的是**会话累计**的 skills 字段
⇒ **开头调一次,之后本会话所有提交永久满足**。实测(2026-09-15 那场):
TDD 只早期调 1 次,之后 **4 个编码任务**(含改判分器输入契约的 A2)一次没调,
**而这道门全程一次没响过** —— 它退化成"一个永远不失败的检查",**比没有门更坏**。

## 新判据(第三版;前两版都被实跑证伪,过程记在工具 docstring)

> 取 `lo` = **上一次 `git commit`** 的时刻(转录里它是 Bash 调用);
> **通过 ⟺ 存在 TDD 调用落在 `(lo, 本次最早那次实现编辑]`**。
> 人话:**自上次提交以来、动手之前,调过 TDD。**

- 第二版用「最近的那条 `type:"user"` 行」当"本轮起点" —— **实测证伪**:
  转录里 user 行**混着工具结果**,且真用户消息的时间戳与工具调用**互相穿插**
  (同一次 Skill 调用 .556 vs 用户行 .604/.605)⇒ 窗口被压成 **49 毫秒** ⇒ **一律误拦**
  (连本次改动自己的提交都被它拦下);
- 第三版改用 `git commit` 作锚,**顺手堵了一个洞**:用"最早那次编辑"会被**上一段工作的编辑**污染
  (同一文件跨两次提交 ⇒ 放行);`git commit` 才是"上一段工作结束"的真实边界。

⚠️ **判不了 ⇒ 不阻断**(打印 `undecidable`)—— 误拦是守卫被关掉的头号原因。
⚠️ 已知边界(D-29 预登记):同一件工作分多次提交时可能被拦 ⇒ 用 `[no-skill: <理由>]` 豁免。

## 交付

- 新 `tools/check_skill_before_edit.py` + `tests/test_skill_gate_timing.py`(**10 条**);
- `.githooks/commit-msg` 的门 2 改为调它(不再 grep 累计字段);
- 改造 `tests/test_hooks.py` 两条既有用例:**按新契约补合成转录**(不是放宽断言)。

## TDD 与验证

- 三条红测试各自**先看红**:工具不存在 → 判据不对 → 锚取错;
- ⚠️ 期间修过**两处我自己的测试 bug**(辅助函数没建目录 ⇒ 报错而非失败),按 TDD 先修测试;
- **★ 真实验证**:拿**本会话真实转录**跑 —— 第二版**拦下了我自己的提交**(49ms 窗口),
  第三版 **exit 0**;
- **突变验证两条**:a 忽略"上次提交"这个锚 ⇒ 2 条红 ✅ · b 忽略"动手之前" ⇒ 5 条红 ✅;
  还原 `diff -q` **逐字一致**、MUTANT 残留 0;
- **584 passed / 2 skipped**(基线 574,+10)。

提交前两问:
① **有决策事项** —— 即 `DEC-020`(签核 **D-29**);三版判据的取舍与**被证伪的两版**已随
   工具 docstring 与本节记录(不另立 DEC:它是该 DEC 的实施);
② 本仓无 CHANGELOG 机制。
@heweidong-ecco
heweidong-ecco merged commit d29870d into main Sep 24, 2026
2 checks passed
@heweidong-ecco
heweidong-ecco deleted the feat/dec020-alpha-skill-gate-timing branch September 24, 2026 10:53
heweidong-ecco added a commit that referenced this pull request Oct 18, 2026
锚点此前停在 2026-09-24 18:57(#80 那次),**比实况旧一次合并**:
它写「`DEC-019` / `DEC-020` 只签了『做』,实现未动」「当前唯一待办 = DEC-019 的实施」,
而 `DEC-019` 的 α+β 已在**同日 19:12 以 #81 合入**。

按我们自己立的规矩(「锚点只放当前为真的断言;live 断言办完就当轮改写」)更正:

- 抬头:上次更新 2026-09-21 → **2026-10-18**;
- `CLAUDE.md` 指针 / `ROADMAP.md` 交接段:**改为「均已实施并合(#81 / #79)」**;
- **唯一未完成项写明 = `DEC-019` 的完整 live 回归**(≈3.5 万 ⇒ 须另批),
  并写清**已跑什么**(canary 0/8 · calibrate 1.00,30,266 token)、**未跑什么**、
  **为什么不能省**(离线 calibrate 测不到真实链路里的误伤);
- 顺带列出**不阻塞的三项**(2× 延迟悬案 · 母体观察 · R1 探针)。

验证:锚点守卫 exit 0 · 584 passed / 2 skipped。

提交前两问:① **本次无决策事项**(纯记录更正,事实与依据均写在正文);
② 本仓无 CHANGELOG 机制。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant