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

fix(lib): the shared docs lookup scripts need Bash 4 but do not say so or probe for it

已关闭 适合新手
#6,496 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

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

调研方向

首先用 grep 在 lib/docs-raw.sh 和 lib/fetch-docs.sh 中查找 ${...,,} 大小写转换展开,将它们替换为可移植的小写转换(tr '[:upper:]' '[:lower:]' 或 [[ =~ ]] 大小写折叠模式),然后重新同步这些脚本在各插件中的重复副本。另一种做法是在两个插件的 prerequisites.json 中声明 Bash 4+,并让 /discovery:check 技能检测版本,同时修正多智能体 README 中的 "Bash 3.2 or later" 那一行。运行 lib/docs-raw.test.sh 和 fetch-docs 的测试(最好在 Bash 3.2 下运行,或用 ,, lint 检查);当脚本通过、或检查技能报告版本要求时即告完成。

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

描述

needs-human needs-triage

No related issue: follow-up from the #6481 Codex review (part of #6020).

Summary

lib/docs-raw.sh (${BASH_REMATCH[1],,}) and lib/fetch-docs.sh (${line,,}, ${H_CTYPE,,} and others) use Bash 4 case conversion. Stock macOS Bash 3.2 exits with bad substitution, so on such a host every docs lookup fails: /discovery:read-docs errors, and the docs-fetcher raw reads in research-sweep and drift-audit fall back to WebFetch. Neither the discovery nor the multi-agent prerequisites.json declares Bash 4, and /discovery:check does not probe the version. The multi-agent README's "Bash 3.2 or later" line is about the role resolver, but a reader can take it to cover the new scripts.

Fix

Pick one: replace the ,, expansions with a portable lowercase (tr '[:upper:]' '[:lower:]' or a case-folding [[ =~ ]] pattern) in the canonical lib/ scripts and re-sync the copies; or declare Bash 4+ in both plugins' prerequisites and have the check skills report it.

Verification

  • Run lib/docs-raw.test.sh and the fetch-docs tests under Bash 3.2 (or with a ,, lint), or the check skill reports the version.

Related

  • #6481
  • #6020
主要语言
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 摘要。