用途:生成 _FEATURES.md 文件,从用户/消费者视角说明代码库“做什么”,按功能或能力组织,而非按目录结构;每个功能锚定到具体源码符号。tree-sitting 告诉你存在哪些符号,_FEATURES.md 说明它们为何存在、共同完成什么。
主要能力:支持大型代码库的层级化文档,根文件按能力领域拆分为子功能文件,智能体从根文件进入,仅在处理相关领域时深入子文件。提供 gather.py 做符号盘点、check.py 检测文档与代码漂移(失效引用、移动符号、死功能、未覆盖符号、孤立子文件),退出码 0 表示干净、1 表示有漂移,可用于 CI 或 pre-commit。
使用方式:依赖 tree-sitting 技能,使用其引擎做 AST 扫描。安装命令:uv venv /home/claude/.venv 2>/dev/null;uv pip install tree-sitter-language-pack --python /home/claude/.venv/bin/python。工作流为三遍合成:第一遍定向扫描并形成假设,第二遍提取详细功能并决定层级,第三遍在所有功能写完后重写概览。常用命令:/home/claude/.venv/bin/python /mnt/skills/user/featuring/scripts/gather.py /path/to/repo --skip tests,.github,node_modules --source-budget 8000;check.py 用法为 /home/claude/.venv/bin/python /mnt/skills/user/featuring/scripts/check.py /path/to/repo [--features _FEATURES.md] [--skip tests,.github]。
适用场景:为代码库提供面向智能体的功能导航文档;大型项目按能力领域分层组织;在 CI 中检测文档漂移。
限制:需要 tree-sitting 技能;tree-sitting 缓存不保存文件源码,缓存命中时 source 为 None,gather.py 会从磁盘重读;纯基础设施、内部工具和测试代码通常跳过;check 仅做引用解析,新代码无文档只作为“未覆盖符号”提示,不强制;完整重新生成是最后手段,优先做针对性更新。其他收费、平台等信息暂未提供。