用途:定期为技能 wiki 做“园艺”式维护,在新增、删除、重命名技能或调整分类后,自动检查 wiki 健康度,避免链接失效、技能孤立、命名漂移、INDEX 不同步。
主要能力:check-links.sh 校验 @ 引用与交叉链接,检测反引号包裹的 @ 链接、相对路径、失效引用、INDEX 中不存在的技能及孤立技能;check-naming.sh 校验目录是否 kebab-case、是否含大写或下划线、frontmatter 字段是否完整、目录是否为空;check-index-coverage.sh 校验技能是否列入分类 INDEX、分类 INDEX 是否被主 INDEX 链接、条目是否有描述;garden.sh 汇总运行全部检查并输出健康报告,另有 analyze-search-gaps.sh 分析缺失技能;报告用 ✅、❌、⚠️、ℹ️ 区分通过、错误、警告与信息。
使用方式:运行 ~/.claude/garden.sh 执行全部检查,或单独运行 ~/.claude/check-links.sh、~/.claude/check-naming.sh、~/.claude/check-index-coverage.sh、~/.claude/analyze-search-gaps.sh;提交技能改动前先运行 garden.sh,修复 ❌ 错误,酌情处理 ⚠️ 警告;重命名或移动技能后用 grep 查找旧路径引用再复查。跨客户端方面,Claude Code 放在本地 skills 目录,Codex 同步到 $CODEX_HOME/skills/gardening-skills-wiki 并重启,GitHub Copilot 需放在可见技能路径或写入项目指令。
适用场景:新增、删除、重命名技能,重排分类,更新交叉引用,怀疑链接失效,以及每周(活跃开发)或每月(稳定期)的周期维护。
限制:无需 MCP;无 MCP 时依据本地说明、标准 shell 或编辑器工具及直接验证,不得声称使用了当前宿主未暴露的 MCP 操作。删除空目录前须先预览并确认路径,再使用平台原生删除方式,不要复制宽泛的递归删除命令。技能名应用主动语态,frontmatter 需含 name、description、when_to_use、version、type 等字段。