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

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

已关闭
  • 哪里不对？
#6,484 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
64/100
Issue 类型
重构
描述清晰度
描述清楚
活跃度
活跃
技术栈
bash, shell
领域
documentation, tooling

调研方向

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.

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

描述

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.
主要语言
Shell
星标
22
派生
2
平均合并
5 小时 11 分钟
30 天内合并 PR
838

环境准备

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