Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

knowledge: docpage-digest correction rounds have no convergence rule or round cap

Aperta Adatta ai principianti
  • Qualcosa non va?
#7,282 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
76/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
markdown
Ambito
documentation

Direzione di ricerca

Inizia da plugins/knowledge/skills/docpage-digest/context/dual-verification.md, in particolare dalle regole dei cicli di correzione intorno alle righe 46–78. Leggi come vengono registrate le correzioni e come vengono riportate le nuove scoperte. Poi aggiungi la regola di convergenza suggerita e un limite di tre cicli, trasferendo le scoperte aperte e la cronologia dei cicli al passaggio all’intervista. Il lavoro è completato quando le regole spiegano sia come evitare scoperte ripetute sotto forma di parafrasi sia cosa succede dopo aver raggiunto il limite.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

priority: low

Summary

/knowledge:docpage-digest's dual-verification rules define how a correction round is recorded, but not when rounds stop or how a correction should be worded so the next re-verify does not raise a new finding against the fix itself. On pages whose rules carry per-event exceptions, rounds can repeat without converging.

Affected area / component

plugins/knowledge/skills/docpage-digest/context/dual-verification.md

Steps to reproduce

  1. Digest a page whose prose restates rules with per-event exceptions, for example https://code.claude.com/docs/en/hooks#exit-code-output and https://code.claude.com/docs/en/hooks#block-the-action-when-a-hook-fails.
  2. Let a re-verify flag a dropped exception in a unit's Summary or Implications, and correct it by adding scope wording.
  3. Re-verify. A different exception is now missing from the new wording. Repeat.

Expected behavior

The skill states a convergence rule for corrections and a round cap, after which open findings move to the interview handoff with their round history.

Actual behavior

  • context/dual-verification.md:46-51 defines one corrections file per unit per round and a per-round index; :66-72 requires an applied record whose "New findings" feed the next round; :74-78 requires each round to sweep every fixed class twice. Nothing bounds the number of rounds or says how to word a correction.
  • Observed on the hooks page: one unit needed four correction rounds. Rounds 1 to 3 each rewrote a conditional rule (exit code 2, onFailure, timeouts) in Summary/Implications prose with new scope wording, and each re-verify found that the new wording dropped a different exception. Round 4 converged only after the run added its own rule: replace paraphrase of a conditional rule with a neutral sentence that points at the claim labels.

Suggested fix

Add to dual-verification.md:

  • a convergence rule: a correction removes paraphrase of a conditional rule and points at the claim labels, rather than adding scope wording;
  • a round cap (for example three rounds), after which open findings go to the interview handoff with the round history.

Environment

knowledge plugin 0.21.1 (line numbers from main on 2026-10-12).

Found during the upstream-pointer sweep (PRs #7061-#7274).

Lingua principale
Shell
Stelle
22
Fork
2
Merge medio
7h 42m
PR unite (30g)
923

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di melodic-software/claude-code-plugins

Tutte le issue di melodic-software/claude-code-plugins

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.