Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#7,281 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
57/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
markdown, shell
Lĩnh vực
documentation, tooling

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Shell
Star
22
Fork
2
Merge trung bình
8 giờ 27 phút
Pull request đã merge (30 ngày)
957

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của melodic-software/claude-code-plugins

Tất cả issue của melodic-software/claude-code-plugins

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.