diff --git a/skills/think-twice/SKILL.md b/skills/think-twice/SKILL.md index 9b7d062..e86a381 100644 --- a/skills/think-twice/SKILL.md +++ b/skills/think-twice/SKILL.md @@ -39,9 +39,9 @@ they can open right now. **Background** is what they already know. | can open the code | exact locations, code, schema | the design one level up; code as an optional anchor | | cannot | conclusion and boundaries | consequences and comparisons | -The table is a default, not a verdict. A reader in the top-left cell who is -optimising for speed may still want the design level and no code at all. When -it is unclear, one direct question is faster than a guess. +The table is a default, not a verdict. A reader who can open the code and knows +the domain may still be optimising for speed and want the design level with no +code at all. When it is unclear, one direct question is faster than a guess. Pitch one level higher than feels natural and let them ask downward. Opening with code or a schema is a choice that needs a reason: they asked for it, or @@ -57,9 +57,10 @@ meaning for it. ### 1. Locate the blocker -Pick the highest one: **level** (pitched at the wrong altitude) | **concept** | -**scope** | **steps** | **token** (undefined word or dangling pointer). Then -name which conclusion, boundary, evidence and next step this text must carry. +The five blockers run from highest to lowest; pick the highest that applies. +**level** (pitched at the wrong altitude), **concept**, **scope**, **steps**, +**token** (undefined word or dangling pointer). Then name which conclusion, +boundary, evidence and next step this text must carry. **Done when:** one blocker is named and every load-bearing slot is listed. @@ -157,7 +158,9 @@ goes, and what to do next, wherever those questions matter. ### Chinese prose for a human reader -Also load [style.md](style.md), the only conditional part of this skill. +When the output is Chinese prose a person will read, and it is not code-heavy, +also load [style.md](style.md) and sweep its list before delivery. It is the +only conditional part of this skill. ## When the rewrite misses diff --git a/skills/think-twice/style.md b/skills/think-twice/style.md index 678f8ad..1454bb2 100644 --- a/skills/think-twice/style.md +++ b/skills/think-twice/style.md @@ -1,12 +1,8 @@ # Style — 中文表述 (optional part) -Load only when the output is Chinese prose for a human reader; even then, skip -code-heavy text. This file is a guardrail against model-flavoured prose; when -model writing no longer needs it, delete the file and every pointer to it (grep -both skills for style.md) — neither core depends on it. - -Every rule is countable. Before delivery, sweep the list once: each rule passes, -or the text changes until it does. +A guardrail against model-flavoured prose. Every rule below names what to look +for and what to change it to. Before delivery, sweep the list once: each rule +passes, or the text changes until it does. ## 句子