new-feedback
Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments. Part of the Agentsmith harness; scaffolds a numbered docs/feedback/NNNN-*.md with the five-stage template (R9 — numbers are never reused).
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 152
- Forks
- 7
01 前言 Front Matter
- name
- new-feedback
- description
- Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments. Part of the Agentsmith harness; scaffolds a numbered docs/feedback/NNNN-*.md with the five-stage template (R9 — numbers are never reused).
- compatibility
- Requires filesystem access; the fast path requires the cross-platform Agentsmith CLI.
03 SKILL.md 正文
New feedback note (harness post-incident)
The point is not to fix THIS bug — it's to change the SYSTEM so this whole CLASS is less likely (core/60). Small, specific, traceable to the incident.
When this fires
You were corrected on something a rule could have prevented; you iterated more than you should have; a human stepped in; you re-derived a decision a past session already made. After fixing the immediate thing, capture the lesson.
Absence gate
Before filing or implementing a missing-item defect, confirm absence with an exact, count-based, or untruncated result. Truncated, paginated, filtered, or summarized search output is incomplete evidence.
Fast path — if the Agentsmith CLI is available
Run agentsmith new-feedback "short symptom" — use .agentsmith/agentsmith on macOS/Linux or
.agentsmith\\agentsmith.cmd on Windows when the command is not on PATH. It computes the next number and writes
docs/feedback/NNNN-<slug>.md with the five-stage template, Status open.
Fallback — no CLI
- Next number = (highest existing
docs/feedback/NNNN-*.md+ 1), zero-padded to 4 digits. Numbers are never reused (R9), even if an old entry was archived. - Create
docs/feedback/NNNN-<slug>.md(Status: open) with the five stages:- Evidence / symptom — what was observed, quoted.
- Failure mechanism — WHY the system allowed it (missing rule / vague instruction / absent guardrail / unreached tool / noisy context — almost never "the model was dumb").
- Bounded edit — the smallest change that prevents the whole class.
- Named surface — exactly where it lands (a core rule, a verify phase, a lint check, a
template, or a hook when the install runs hooks); prefer a deterministic surface over prose
the model can skip. Record it on the line
- **Surface:** file: <path> | text: <literal line>or- **Surface:** verify: <phase>. - Non-regression — the check that stays red on recurrence. Until it's real, Status stays open.
Report
Name the file, then land the bounded edit on its named surface and flip Status to applied.
04 同仓库更多 Skills
portable-fixture
Fixture proving that skill identity comes from metadata rather than its installation path.
portable-fixture
Fixture proving that skill identity comes from metadata rather than its installation path.
writing-rules
Write or review anything an agent reads — a core rule, a profile gate, a SKILL.md description, an instruction-file line, a subagent prompt, a handoff note, a verify-phase label. Part of the Agentsmith harness; supplies the levers that decide whether a line changes behaviour or only costs tokens — the two loads, context pointers, the ladder, completion criteria, leading words, the no-op test. Its default move is deletion, so it earns most on a draft that already exists.
wayfinder
Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts. Use when the destination is known but important decisions, dependencies, or scope are not yet clear enough to implement safely.
verify
Answer "is this shippable / done?" with evidence before a commit or PR — fires on "verify", "is this done", "ready to ship?", pre-commit or pre-PR. Part of the Agentsmith harness; runs the project's verify phases and never claims "passing" without showing the output (R5).
new-research
Start a durable research / source note that captures what you read and found — fires on "start a research note", "capture these sources", "log my research". Part of the Agentsmith harness; scaffolds docs/research/<slug>.md so findings live in the repo, never in disposable memory (R9), and are never silently deleted.