Skill 目录生成器

本地 Skill 越积越多，目录却跟不上

在 WorkBuddy、Trae 等环境里，技能往往散落在多个目录里，每个包一份 SKILL.md，人工整理成「能扫一眼就知道有什么、归哪类」的目录，成本高且容易过期。这个技能的目标是：自动遍历技能树、解析元数据、按规则归类，并输出可读的结构化文档，而不是再写一份宣传文案。

它怎么工作

• 目录发现：未指定路径时，会尝试探测常见客户端的 skills 根目录；也可通过环境变量或命令行参数显式指定扫描范围。
• 分类逻辑：读取各技能的 description，与 config.yaml（或脚本内置的 SKILL_CATEGORIES）中的关键词表匹配。计分规则是：ASCII 关键词整词命中 +2、子串 +1；中文短语子串命中 +2；同分时取 priority 更小（优先级更高）的分类。
• 容错与吞吐：某个 SKILL.md 解析失败会记日志并跳过，不阻断整批任务；编码会尝试 UTF-8 / GBK / Latin-1；未安装 PyYAML 时回退内置分类表。解析阶段用 ThreadPoolExecutor 并发，路径遍历走 pathlib，日志用滚动文件避免无限增长。
• 运行形态：既可单次「开箱即用」跑一遍，也适合用系统定时任务周期性刷新目录；目标目录不存在时会给提示，定时场景下还可生成骨架目录而不直接失败。

适用边界

分类质量高度依赖 description 里的措辞与关键词表是否对齐；新领域技能可能需要改 config.yaml 或内置字典。生成的是目录与文档视图，不会替你执行各 skill 的业务逻辑；多机或多用户场景下，每台机器上的 skills 路径仍需各自配置或探测。