技能保险库dargonburn337845818/skill-group

dsh-skill-vault

DSH 技能保险库：统一管理蒸馏出的 skill，按场景/单 skill 开关启用，并提供 agent 工具与 Web 面板。

License: MIT

简介

dsh-skill-vault 是 DSH（DeepSeek Harness）生态中的技能库插件。它把分散的 skill 按“使用场景”组织，并提供场景级与单 skill 级开关。启用状态保存在本地数据目录，不进入公开仓库。

本仓库同时承载插件源码与开源 skill/语料，远程仓库为 skill-group。

功能

- 统一存放：将蒸馏出的 skill 放入 vault/，按场景组织，避免目录臃肿。
- 按需启用：场景级开关 + 单 skill 开关，默认关闭，不抢上下文。
- Agent 工具：查询、启用、禁用、入库。
- Web 面板：可视化开关面板，可与过程监视器联动。
- 可自动推送：新增 skill 通过 skill_vault_add 准备入库；默认交互确认，配置凭据后可用 scripts/push.sh --yes 全自动提交推送。

Agent 工具

| 工具 | 作用 |
|---|---|
| skill_vault_list | 按场景/专家/来源/启用状态查询 |
| skill_vault_enable  [scope=global\|session] | 开启一个 skill 或一个场景 |
| skill_vault_disable  [scope=global\|session] | 关闭一个 skill 或一个场景 |
| skill_vault_add | 将含 SKILL.md 的蒸馏目录复制进 vault 并生成 manifest（不提交 git） |

启用语义

- 默认：所有 skill 关闭，只出现在插件目录中。
- 开启后：插件调用 ctx.skills.register()，skill 进入 DSH 全局技能目录。
- scope=global 写入 ~/.dsh/skill-vault/enabled.json，跨重启生效。
- scope=session 只影响当前进程，重启恢复全局状态。

仓库结构

src/                 # 插件 TypeScript 源码
vault/               # 开源 skill 仓库
├── skills/          # 按场景组织的技能包
├── corpus/          # 开源语料/产物
└── manifest.schema.json
scripts/             # 构建、校验、推送（默认交互，可自动）
tests/               # 插件与 vault 校验测试
lib/                 # 预构建产物（提交到仓库）

开发与构建

bash scripts/build.sh
npm run build:client
npm test

遵循 dsh-optimization-consensus：

- 不自动热装到运行中的 agent；
- 先在隔离 DSH_HOME 做配置导出与冒烟；
- 回滚恢复实际文件，不只改 package.json pin；
- 插件默认不主动 push；自动化需显式启用（--yes/PUSH_CONFIRM=yes），推送前完成校验与 review。

快速启动与发布

- QUICKSTART.md：安装、加载、开启 skill、发布新版本。
- DESIGN.md：模块设计说明。
- 推送 v* tag 后，.github/workflows/release-plugin.yml 会校验 vault、打包并创建 GitHub Release。

推送

默认交互模式：

bash scripts/push.sh

脚本会提示确认并执行 git add -A && git commit && git push；凭据由 git credential helper 或已配置的认证提供，脚本不会让模型持有或粘贴密码。

全自动模式（CI / agent 已配好凭据时）：

bash scripts/push.sh --yes --message "vault: update distilled skills"
或
PUSH_CONFIRM=yes PUSH_MESSAGE="vault: update distilled skills" bash scripts/push.sh

自动模式仍保留安全护栏：内部产物（assignments/、evals/）会被拦截，enabled.json 等个人状态不会进入公开仓库。

贡献与安全

- 贡献流程：CONTRIBUTING.md
- 漏洞上报：SECURITY.md
- 社区行为：CODE_OF_CONDUCT.md
- 公开仓库不发布内部开发产物：assignments/ 与顶层 evals/ 已通过 .gitignore 排除。

许可证

MIT