Agent Skills
返回列表
技能台账管理

技能台账管理

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_58fad8c3/skill-inventory-v1。

技能介绍

问题从哪来

很多人维护《自制技能清单_*.md》这类手写台账，时间一长就会出现声明数量与磁盘目录不一致：清单里写了某个技能，目录里已经删了；或者你在 ~/.workbuddy/skills/ 下新增了带 agent_created: true 的自制技能，清单却从没登记。更麻烦的是，缺少 SKILL.md、frontmatter 不完整，或备份目录混在 skills 树里，肉眼很难系统排查。

技能如何工作

本技能把文件系统当作事实源，通过 scripts/skill-inventory.py（纯标准库、无第三方依赖）扫描：

  • 用户级：~/.workbuddy/skills/（固定绝对路径）
  • 项目级：当前工作目录下的 /.workbuddy/skills/（由 --out 所指的 cwd 决定）

判定上不会盲信手写表格里的数字：自制技能以 SKILL.md frontmatter 中 agent_created: true 为准；台账声明从旧清单表格第二列反引号技能名用正则提取（过滤正文里的散文反引号）。由此汇总偏差：台账失效、自制未登记、以及卫生类问题（无 SKILL.md / 无 frontmatter）。

运行后在 --out 目录落地 skill_inventory_*.json（含 records 与 drift，供下游编排/审计）和 skill_inventory_*.md（偏差速览、自制权威台账、官方参考与用法）。若存在上一版 JSON，还会生成变更摘要，对比总量与自制/官方增减。

边界与注意点

  • --out . 同时影响输出位置、旧台账 自制技能清单_*.md 的 glob 查找，以及项目级扫描根；文件名若不是默认模式，需用 --ledger 显式指定。
  • 卫生检查不会自动识别 xxx.backup-日期 这类重复副本，可能仍被计入总数，需人工比对后再清理；归档 zip 勿放在 skills/ 内，否则会被下次扫描当成目录。
  • 大量官方技能 description 为英文时，依赖内置 EN_CN_FUNC 映射；未收录的 ID 功能列会退化为英文原文。

使用场景

  • 维护《自制技能清单_*.md》后发现表格里的技能数与 ~/.workbuddy/skills/ 实际目录对不上，需要以磁盘为准重算并标出失效与漏登项。
  • 在本地批量新增、删除或重命名带 agent_created: true 的自制技能后，要刷新 MD/JSON 台账并可选对比上一版 JSON 生成变更摘要。
  • 准备用 skill-orchestrator 串流水线前，先跑一遍扫描拿到 drift 与全量 records，把 json 当作编排器的技能目录输入。
  • 排查 skills 目录卫生问题：缺少 SKILL.md、frontmatter 不完整，或备份副本混在树里导致总数虚高，需要结构化清单辅助人工清理。

适合人员

  • 在 WorkBuddy 用户目录下持续沉淀大量自制技能、仍用手写 Markdown 表格登记、需要权威视图的对照维护者。
  • 要把技能资产 json（含 drift）交给下游编排或审计脚本、且要求先理清目录再串流程的自动化编排实践者。
  • 负责团队或项目级 `/.workbuddy/skills/` 与用户级目录双范围盘点、并需与旧清单表格第二列技能名逐条对账的治理同学。
  • 计划用 automation_update 做每周一固定跑 skill-inventory.py、避免台账再次过期的长期资产管理员。