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

feat: adopt the shared docs lookup across fetching skills and agents

Đang mở
  • Có gì không ổn?
#6,484 1 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ó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
64/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
bash, shell
Lĩnh vực
documentation, tooling

Hướng nghiên cứu

Start by reading the shared lookup delivered in #6348: lib/fetch-docs.sh, lib/docs-cache.sh, and the /discovery:read-docs skill, plus scripts/sync-shared-copies.sh. Build the inventory.txt from the caller paths listed in the issue, then update each to invoke the lookup (or add the one-line WebFetch pointer for discovery-only callers), syncing the scripts into discipline, knowledge, plugin-quality, instruction-placement and harness-memory. Done means the grep -L command over inventory.txt prints 0 and scripts/sync-shared-copies.sh --check, scripts/check-changelog-parity.sh --check, and the tests for changelog-status and check-doc-citations all exit 0.

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

Mô tả

needs-triage priority: medium

No related issue: follow-up to #6020 (Phase 10 of the docs-cache plan); part of #6020.

Summary

#6020 asks to replace copied upstream docs content with pointers plus a cached lookup layer. #6348 (merged) delivered the shared docs cache, the fetcher (lib/fetch-docs.sh, lib/docs-cache.sh) and /discovery:read-docs. No existing skill or agent uses it yet. This issue adopts the lookup in every skill and agent that fetches upstream documentation.

Fix

Every caller below goes through the lookup (/discovery:read-docs, or lib/fetch-docs.sh and lib/docs-cache.sh from scripts). A caller that only discovers pages (finds candidate URLs, never relies on page content) keeps WebFetch and gains a one-line pointer to the rungs in the upstream-drift convention.

Each plugin that newly carries the lookup gets the synced scripts and the procedure text, plus a version bump and a CHANGELOG line (a changelog fragment for plugins listed in scripts/fragment-plugins.txt).

Freshness per caller:

  • --max-age 0 (fresh bytes required): /harness-config:audit (audit-engine.sh, check-doc-citations.sh, check-effort-pins.sh; it runs after a Claude Code update), /harness-ops:changelog (changelog-status.sh; its purpose is the newest release), and /knowledge:docpage-digest absence-establishing reads (the Anthropic docs profile binds absence to a fresh raw fetch with a recorded length). A failed forced fetch returns unread, never stale bytes.
  • Default TTL with the age shown: all other callers. The read reports retrieved (bytes first fetched) and validated (last confirmed current); age counts from validated.

Callers named in the plan:

  • discovery: research (context/discipline.md lines about ad-hoc curl and WebFetch, SKILL.md), research-deep (SKILL.md), researcher agent
  • discipline: recheck-against-upstream, recheck-against-upstream-deep, do-your-research, sweep-all (reference/batched-pass.md)
  • harness-config: audit (SKILL.md, scripts/audit-engine.sh, scripts/check-doc-citations.sh; --cache --max-age 0)
  • harness-ops: changelog (scripts/changelog-status.sh, context/read-actions.md), inventory, audit-native-overlap, known-issues (context/action-status.md)
  • plugin-quality: auditor agent
  • instruction-placement: migrate (SKILL.md, reference/sources.md)
  • harness-memory: audit (context/update.md)
  • knowledge: docpage-digest (context/anthropic-docs-profile.md), map-corpus (discovery/link-map-format.md)

Plugins that need the synced scripts added: discipline, knowledge, plugin-quality, instruction-placement, harness-memory.

Verification

  • A written inventory file lists every path above, one per line. grep -L -F -e '<exact pointer line>' -e 'docs-cache.sh' -e 'fetch-docs.sh' $(cat inventory.txt) | wc -l prints 0, where the pointer line is the fixed one-line WebFetch pointer and the other two patterns match a lookup invocation. A bare /discovery: match does not count, since every discovery skill already contains it.
  • scripts/sync-shared-copies.sh --check exits 0.
  • scripts/check-changelog-parity.sh --check exits 0.
  • Per-caller tests for the --max-age 0 scripts (changelog-status, check-doc-citations) still pass.

Related

  • #6020 (umbrella)
  • #6348 (shared docs cache, fetcher, /discovery:read-docs)
  • Sibling follow-ups: the copied-content sweep (Phase 11) is filed separately.
Ngôn ngữ chính
Shell
Star
22
Fork
2
Merge trung bình
5 giờ 4 phút
Pull request đã merge (30 ngày)
825

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.