Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン 初心者向け
#7,282 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
76/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
markdown
領域
documentation

調査の方向性

まず plugins/knowledge/skills/docpage-digest/context/dual-verification.md を確認し、特に46~78行付近の修正ラウンドのルールを読みます。修正の記録方法と、新たな発見を引き継ぐ方法を確認してから、提案されている収束ルールと3ラウンドの上限を追加し、未解決の発見事項とラウンド履歴をインタビューへの引き継ぎに含めます。完了条件は、言い換えによる同じ発見の繰り返しを避ける方法と、上限に達した後の処理の両方がルールで説明されていることです。

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
Shell
スター
22
フォーク
2
平均マージ
8時間 34分
マージ済み PR(30日)
946

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

melodic-software/claude-code-plugins のほかの issue

melodic-software/claude-code-plugins の issue をすべて見る

似ている issue

Shell/Bash の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。