Skip to content

fix(skills): external-resource verification + Spec axis traceback - #12

Merged
leing2021 merged 1 commit into
mainfrom
fix/external-resource-signal-and-spec-traceback
Jul 22, 2026
Merged

fix(skills): external-resource verification + Spec axis traceback#12
leing2021 merged 1 commit into
mainfrom
fix/external-resource-signal-and-spec-traceback

Conversation

@leing2021

Copy link
Copy Markdown
Owner

背景

PR #10 的 skill-write 误纳入暴露了一个失败模式:用户提到外部资源时,brainstorm 误判为"纳入"而非"已解决",误解一路传播到 merge 才暴露。三个 gate(plan/work/review)都假设上游正确,缺回溯。

改动

1. brainstorm 外部资源信号核实01-brainstorm/references/premise-challenge.md

  • 新增 rule 5:用户提到已有资源时,反向核实意图——是"纳入这里"还是"已解决、不用管"
  • 附 failure mode 说明:跳过此检查导致反向 scope creep

2. review Spec 轴加需求回溯04-review

  • spec-reviewer 现在不仅 plan-vs-diff,还要 trace back 到用户原始措辞(brainstorm scope)
  • 捕获"plan 忠实实现了被误解的需求"这类 directional misunderstanding
  • Core rule 7 + reviewer-selection.md 同步更新

验证

```
204 pass / 0 fail / 805 expect() calls
```

SKILL.md 行数未增(01-brainstorm 仍 98,规则落 references/)。

Prevents the failure mode where a misunderstood user signal (mentioning
an existing resource) propagates through all 5 pipeline stages and
surfaces only at merge.

- 01-brainstorm/premise-challenge.md: add rule 5 — when the user
  references an external resource, reverse-verify intent (incorporate
  vs already-handled) before scoping. Failure mode documented.
- 04-review: Spec axis now traces back to the user's original wording
  (brainstorm scope), not just plan-vs-diff. Catches directional
  misunderstandings the plan itself encoded.
- tests: +1 contract test (premise-challenge external-resource check)

204 pass, 0 fail. SKILL.md line counts unchanged (rules in references/).
@leing2021
leing2021 merged commit 4a746c5 into main Jul 22, 2026
2 checks passed
@leing2021
leing2021 deleted the fix/external-resource-signal-and-spec-traceback branch July 22, 2026 11:46
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