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

Fermée Adaptée aux débutants
  • Quelque chose ne va pas ?
#7,282 2 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
76/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
markdown
Domaine
documentation

Piste de recherche

Commence par plugins/knowledge/skills/docpage-digest/context/dual-verification.md, en particulier par les règles des cycles de correction autour des lignes 46–78. Lis comment les corrections sont consignées et comment les nouvelles découvertes sont reprises. Ajoute ensuite la règle de convergence proposée et une limite de trois cycles, en transmettant les découvertes ouvertes et l’historique des cycles au relais vers l’entretien. Le travail est terminé lorsque les règles expliquent à la fois comment éviter les découvertes répétées sous forme de paraphrases et ce qui se passe une fois la limite atteinte.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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).

Langage dominant
Shell
Étoiles
22
Forks
2
Merge moyen
1 h 22 min
PR mergées (30 j)
931

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de melodic-software/claude-code-plugins

Toutes les issues de melodic-software/claude-code-plugins

Issues similaires

Plus d'issues Shell/Bash

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.