Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

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

未关闭 适合新手
  • 哪里不对？
#7,282 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
76/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
markdown
领域
documentation

调研方向

从 plugins/knowledge/skills/docpage-digest/context/dual-verification.md 开始，重点阅读第 46–78 行附近关于修正轮次的规则。了解如何记录修正以及如何延续新发现，然后添加建议的收敛规则和三轮上限，并将未解决的发现及轮次历史交给访谈环节。完成标准是：规则既说明如何避免以改述形式重复提出发现，也说明达到上限后会如何处理。

由索引模型根据 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
平均合并
7 小时 42 分钟
30 天内合并 PR
923

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

melodic-software/claude-code-plugins 的其他 Issue

查看 melodic-software/claude-code-plugins 的全部 Issue

相似的 Issue

更多 Shell/Bash Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。