JohnXu22786/skill-manager

README 摘要

repertoire — 技能曲目库 dsh（DeepSeek harness）插件： 技能的发现、加载、创建与统计 。 - 多级目录自动发现 — 从项目区 / 用户区 / 插件自带区三个 zone 递归发现技能，优先级明确、冲突可见 - 渐进式披露 — 目录索引（名称+用途）→ 技能正文（按需加载）→ 附属资源（按需读取/运行），三级暴露，成本可控 - 创建向导 — 一条命令生成规范技能骨架，生成即自检，新技能从出生起就是干净的 - 校验与统计 — 发现时强校验（命名/元数据）， audit / check / forge 时全量审计；运行时账本记录扫描、加载、运行、创建等活动 - 零依赖 — 纯 Python 标准库实现（≥3.10），目录即插件，无需安装任何第三方包 目录结构 安装 零依赖，两种方式任选： 快速开始 list 、 audit 、 check 、 status 支持 --json 输出机器可读结果；所有命令支持 --config 指定配置文件。 技能格式规范 一个技能 = 一个目录 + 一个 SKILL.md 标记文件： SKILL.md 顶部是 围栏包裹的元数据块： 元数据解析器实现为严格的 YAML 子集（纯标准库）：支持普通/单双引号标量、列表、 / 块标量（含 chomping）、注释；不支持嵌套映射、锚点等高级构造——遇到不支持的内容会报错并给出行号，而不是静默解析错误。需要完整 YAML 的宿主可自行替换该解析器（接口见 repertoire/frontmatter.py ）。 多级目录发现 zone 按优先级从高到低： 优先级 zone 默认位置 用途 1 workspace /.dsh/skills 项目私有技能 2 personal /.dsh/skills 个人常用技能 3 bundled /skills 插件自带技能 4 extra- 配置指定 其他来源 扫描规则： - 技能目录位于 zone 根下一层（ / /SKILL.md ）或两层（ / / /SKILL.md ，支持分组），更深的目录忽略 - 隐藏目录（ . 开头）忽略；标记文件名可配置（默认 SKILL.md ） - 同名冲突 ：高优先级 zone 胜出，低优先级副本记为「影子」（shadow）——目录中只出现一份，但审计会明确报告被压制的副本及其来源 zone - 损坏条目 ：目录里有标记文件但元数据无法解析（如名字与目录不符、非法命名、缺描述），不会进入目录，而是进入「损坏」清单，附具体原因 渐进式披露 级别 内容 触发方式 成本 一级 · 索引 名称、用途、来源、体积、状态 会话开始自动注入（ catalog.menu 事件） 极低，不含正文 二级 · 正文 SKILL.md 全文 skill.open 按需加载 受 max open bytes 限…

分类