用途：维护已存在的 Open Knowledge Format（OKF v0.1）知识包。知识若固定指向不断变化的来源会悄悄失效，本技能负责扫描、报告漂移、只刷新移动过的内容、重新固定指纹并重新发布，是知识三件套中的维护环节（feynman-walkthrough 创建知识包，okf-site-kit 发布，gardener 保持其准确）。
主要能力：先定位本技能的辅助脚本，需从目标仓库执行，因此要解析一次基准目录并在所有位置使用，包括子代理提示，且必须传入字面绝对路径： SKILL_DIR="<this skill's base directory>" SKILL_DIR=$(find ~/.claude ~/.config ~/.agents -type d -name 'knowledge-gardener' 2>/dev/null | head -1)
状态语义：git 来源固定 HEAD（未提交更改带 +dirty 标记），file 与 dir 来源固定 sha256，外部 URL/主题来源无本地指纹。每个主题状态为 FRESH（指纹全部匹配）、STALE（至少一个来源漂移）、UNKNOWN（无法指纹化，如外部 URL、路径移动）、ERROR（frontmatter 或 pins 无法解析）。sweep 在出现 STALE 或 ERROR 时以非零码退出，可充当 CI 式门禁；只有 UNKNOWN 时退出 0。
使用方式：先找到 Python 解释器（要求 3.10 及以上；若 $SKILL_PYTHON 已设置则使用它，否则依次尝试 python3、python、py -3，跳过安装占位 stub），并将找到的解释器替换到所有命令中。然后运行： python3 "$SKILL_DIR/assets/garden.py" sweep <root> [<root> ...] 扫描用户指定或约定位置（如仓库内 docs/knowledge/、用户级 ~/knowledge/）的知识根，查找声明 okf_version 的 index.md 作为包根，解析每个讲解文件的 sources: pins。若输出 GARDEN_RESULT: NO_BUNDLES 则说明并停止。
随后如实报告中每个主题的状态；对过期的 git 来源给出固定 SHA 与当前 SHA、git diff --stat 摘要及变更文件名。对每个 STALE 主题按 references/refresh-playbook.md 读取实际变化、映射到讲解段落、仅重写漂移段落（并修正失效的 FAQ）、重新固定指纹并在包内 log.md 追加更新；UNKNOWN 走询问或人工复查处理，ERROR 先修复 frontmatter。若包有生成网站，用 okf-site-kit 重新构建。最后重新 sweep，要求全部到达 FRESH 或 UNKNOWN，否则回到刷新步骤；若主机有调度器，可仅一次提议安排下次扫描（活跃仓库默认每周），仅在明确同意后创建。
适用场景：存在固定外部来源、需要长期保持准确的 OKF 知识包仓库；可作为漂移检测的 CI 门禁；需要机器可读结果时可使用 json 子命令。
限制：该技能的收取方式、价格与平台支持暂未提供；UNKNOWN 的外部来源永久无法校验；需要 Python 3.10 或更新版本，无 Python 时按其回退方案处理或停止并告知用户；调度为可选且需显式同意，报告先于修复，避免擅自改写知识包。