Gardening Skills Wiki

用途

Gardening Skills Wiki 用于维护技能知识库（skills wiki）的健康状态。技能库在长期使用中会出现链接失效、技能孤立、命名漂移、INDEX 文件不同步等问题，该工具通过自动化健康检查来保持知识库质量，避免手动逐项排查。

主要能力

该工具提供多个检查脚本，覆盖以下方面：

链接验证（check-links.sh）：检查反引号包裹的 @ 链接（反引号会禁用解析）、相对路径（如 skills/ 或 skills/gardening-skills-wiki/~/，应改为 skills/ 绝对路径）、所有 skills/ 引用是否指向存在的文件、INDEX 文件中引用的技能是否存在、以及孤立技能（未出现在任何 INDEX 中）。修复方式包括移除反引号、将相对路径转为绝对路径、更新断链、将孤立技能加入分类 INDEX、移除已删除技能的引用。
命名一致性（check-naming.sh）：检查目录名是否为 kebab-case、是否包含大写或下划线、frontmatter 字段是否齐全（name、description、when_to_use、version、type）、技能名是否使用主动语态（而非“How to...”）、以及空目录。修复方式包括重命名目录、补充缺失的 frontmatter 字段、删除空目录、改写为主动语态。
INDEX 覆盖（check-index-coverage.sh）：检查所有技能是否列在其分类 INDEX 中、所有分类 INDEX 是否从主 INDEX 链接、INDEX 条目是否包含描述。修复方式包括将缺失技能加入 INDEX、将分类链接加入主 INDEX、为 INDEX 条目补充描述。

此外还有 analyze-search-gaps.sh 用于分析搜索缺口（缺少哪些技能）。

使用方式

运行全部检查：

~/.claude/skills/meta/gardening-skills-wiki/garden.sh

或运行特定检查：

~/.claude/skills/meta/gardening-skills-wiki/check-links.sh
~/.claude/skills/meta/gardening-skills-wiki/check-naming.sh
~/.claude/skills/meta/gardening-skills-wiki/check-index-coverage.sh

分析搜索缺口：

~/.claude/skills/meta/gardening-skills-wiki/analyze-search-gaps.sh

主脚本 garden.sh 会运行所有检查并提供健康报告。

适用场景

添加新技能后
删除或重命名技能后
重组分类后
更新交叉引用后
怀疑链接失效时
定期维护：活跃开发期每周一次，稳定期每月一次

限制

该工具主要针对特定目录结构（~/.claude/skills/）下的技能库，检查逻辑和修复建议基于该结构。其他环境或自定义结构可能需要调整。资料中未提供关于收费、价格、平台支持范围等更多信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制