SKILL.md-Sanierung: Checklisten, Kommandolisten, wiki-status-Hard-Rule, wiki-query-Filingpruefung (schliesst #70, #74, #75, #78)
Files changed: - CHANGES.md - VERSION - instructions/CONTRACT.md - instructions/wiki-ingest/SKILL.md - instructions/wiki-lint/SKILL.md - instructions/wiki-manage/SKILL.md - instructions/wiki-query/SKILL.md - instructions/wiki-status/SKILL.md
This commit is contained in:
@@ -217,6 +217,29 @@ reads, and no tool hook is wired on the primary harness at all - so a `head -100
|
||||
to score. The other half of the claim, what ended up in the context window, produces no event
|
||||
anywhere by construction. Gitea #72 records what a test would cost and why it was not bought.
|
||||
|
||||
### When a skill carries a copy-in checklist
|
||||
|
||||
Anthropic's skill-authoring guidance suggests, for a "particularly complex workflow", a checklist
|
||||
the agent copies into its response and ticks off as it goes. It names no threshold, so this repo
|
||||
sets one - otherwise the two skills that have such a block and the three that do not read as an
|
||||
accident rather than a decision.
|
||||
|
||||
A `SKILL.md` carries the block when **one** of its flows runs to eight steps or more *and* that
|
||||
flow contains steps whose omission is silent - a judgment call, a field filled by hand, a
|
||||
cadence check, anything no tool error and no validator would report missing. Both halves are
|
||||
required. Length alone is not the problem: a long flow of tool calls announces its own gaps,
|
||||
because the next call fails without the previous one.
|
||||
|
||||
Two skills qualify today, and the block names each of their numbered steps once, verbatim:
|
||||
`wiki-ingest` (twelve steps, of which `## Not Extracted` in step 6, the coverage check in step 10
|
||||
and the lint cadence in step 12 all fail quietly) and `wiki-lint` (nine, with steps 3-6 pure
|
||||
judgment). The other three do not, and the reason is worth stating so nobody adds one out of
|
||||
symmetry: `wiki-manage` has two flows of seven, `wiki-query` six, `wiki-status` five, and none of
|
||||
them is long enough for a reader to lose the thread.
|
||||
|
||||
The block says that it is to be copied and carried, not read. A checklist read once is the table
|
||||
of contents it replaced.
|
||||
|
||||
### How much reasoning a step may carry
|
||||
|
||||
"Cut the reasoning" and "keep enough to decide an edge case" are one sentence pulling two ways,
|
||||
|
||||
Reference in New Issue
Block a user