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

knowledge: docpage-digest collision check can match the checklist's prose line, and no tag-exempt sub-shape fits the Documentation-Index banner

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
57/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
markdown, shell
领域
documentation, tooling

调研方向

Read plugins/knowledge/skills/docpage-digest/SKILL.md, templates/checklist.md, and context/anthropic-docs-profile.md. Check how the collision check selects the Canonical URL value and how the profile categorizes the raw-md Documentation-Index banner. Update those instructions so the check reads the value line and the banner has one consistent disposition; verify both against the reproduction steps in the issue.

由索引模型根据 Issue 内容生成。

描述

priority: medium

Summary

Two small gaps in /knowledge:docpage-digest's template and publisher profile:

  1. The run-start collision check reads "the Canonical URL line" of an existing checklist, but the checklist template has the words Canonical URL in instructional prose three lines above the value line. A first-match read picks up the prose, finds no URL, and refuses a legitimate resume.
  2. The code.claude.com raw-md channel prepends a Documentation-Index banner to every page, but none of the profile's five tag-exempt sub-shapes fits it, so each digest improvises a tag for it.

Affected area / component

plugins/knowledge/skills/docpage-digest (templates/checklist.md, SKILL.md, context/anthropic-docs-profile.md)

Steps to reproduce

Gap 1:

  1. plugins/knowledge/skills/docpage-digest/templates/checklist.md:8 says "Fill Canonical URL and the resolved work root at run start"; the value line is - Canonical URL: at :11.
  2. SKILL.md:79 tells the collision check to "read the Canonical URL line" from an existing checklist.
  3. Run grep -m1 'Canonical URL' <work-root>/<slug>/docpage-digest-checklist.md on any filled checklist. It returns line 8's prose, not the value.

Gap 2:

  1. context/anthropic-docs-profile.md:29-31 says the channel prepends a Documentation-Index banner (verified on 187/187 pages) whose embedded fetch imperative is quoted data.
  2. context/anthropic-docs-profile.md:197-205 lists five tag-exempt sub-shapes: consumer-surface, archive-descriptive, metadata, navigation-pointer, blog-apparatus. None names the banner.
  3. context/anthropic-docs-profile.md:227-229 (pointer convention) says a directive pointer takes a vocabulary tag, not the exempt disposition. The banner directs the reader to fetch the index, so navigation-pointer conflicts with that rule.
  4. Digest any code.claude.com page and look at how its intro unit tags the banner row.

Expected behavior

The collision check reads the value line only, and the profile names one disposition for the channel banner.

Actual behavior

  • Gap 1: a naive first match reads the prose line and refuses the resume.
  • Gap 2: across 22 slices from one run, the banner row was tagged three different ways: 17 as tag-exempt (navigation-pointer), 4 as metadata, and 1 as cc-applicable.

Suggested fix

  • Anchor the collision check to ^- Canonical URL: in SKILL.md, or reword the template prose so it does not contain the literal label.
  • Name a single disposition for the raw-md channel banner in the profile's raw-md artifact list.

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 小时 27 分钟
30 天内合并 PR
957

环境准备

  • 没有 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 摘要。