dsh-lantai:给 agent 的 skill 库做体检、核验与勘程

前言

在 DeepSeek Harness(DSH)里,skill 会被注入到此后每一个匹配的会话,成为 agent 的默认前提。常见做法是不断追加「学到的东西」;一旦某条 skill 写错、过时或彼此矛盾,影响的不是单次检索,而是后续每一次判断,而且往往不会再有人逐条重读。

兰台·簿(dsh-lantai)把 skill 库当成一本账册:记什么要先过审,过期要按勘程复核,该退场则归档而非悄悄删掉。下面介绍它是什么、能做什么,以及如何安装与上手。

这是什么

兰台·簿是 DSH 社区插件,维护者为 Erdoschn,在插件目录中归类为工作流。一句话定位:给 agent 的 skill 做精炼、去重与降本增效——写入前核验、库内体检、主题图谱,以及阶梯化复核与可恢复归档。

与「记得越多越好、直接追加」的记忆方案不同,兰台的立场是:部分写入要求不被允许;写入的须有效、无害;过时的应淘汰;体检的直接目的之一,是指出「哪几条 skill 现在在误导你」。

为什么需要核验

判断标准不是「这条有没有用」,而是「它错了会怎样」。错的 skill 不像错的搜索结果——你不看就没影响;它会主动参与每一次判断。

README 中的示例:模型随手写一条 skill,未通过核验则一字未写,并可能因形状、实质、安全等原因被驳回,例如名称非 kebab-case、描述过笼统、正文过短、缺少「验证」或「边界」小节、正文缺少具体命令或路径,或出现关闭沙箱、直推默认分支等不安全建议。若没有核验,该条会入册并在往后每个匹配会话里生效。

核心能力:三个减法动作

体检(兰台·诊)

不论 skill 是你写的、别人给的还是从 GitHub 拉的,一次只读扫描可报告:矛盾、孤岛、薄覆盖、逾期复核、缺验证等;每条发现附带「该做什么」,不改文件。

安装后可在对话里让 agent 体检 skill 库。README 示例输出形态如下:

7 条 skill,4 个主题,0 个严重、0 个中等问题、3 个提示
[low] 主题「windows」只有 2 条 → 知识缺口,也是下一步该学什么的方向

图谱(兰台·谱)

按主题聚簇,并从文本推出可证实的实边,输出 JSON 或可直接嵌进 README 的 Mermaid;导入的 skill 同样可建图。

核验(写入闸门)

经 skill_distill(兰台·录)入册前必过审;驳回时不写入任何字节。规则分四类:形状、实质、安全、唯一。

勘程与归档

勘程(阶梯化复核)

复核间隔由已勘次数决定,README 给出的阶段表如下:

阶段 间隔 该做什么
0 7 天 轻勘:验证命令还通得过吗
1 14 天 复查
2 30 天 环境复核:版本、路径、开关变了没
3 60 天 价值复核:被更好的做法取代了吗
4 90 天 成本复核:命中率如何,还值得占上下文吗
5 180 天 终审:重写、收缩,或删除

逾期超过 180 天,体检会建议归档,但不会自动删除。

归档(可撤回的删除)

skill_retire(兰台·削)先出示确认卡片;同意后目录移到 skills.retired/<name>-<时间戳>/,并留 RETIRED.md 记录原因与恢复方式。归档原因必填,没有原因则卡片不会出现。

八个工具

工具 卡片名 干什么
skill_health 兰台·诊 矛盾、孤条、单薄、逾期、缺验
skill_graph 兰台·谱 主题聚簇 + 实边,JSON / Mermaid
skill_distill 兰台·录 过核验后入册
skill_catalog 兰台·索 列出目录、复核等级、下次复核时间
skill_audit 兰台·校 算到期,列出该跑的验证命令
skill_attest 兰台·勘 盖章,间隔自动拉长
skill_retire 兰台·削 确认后归档,可恢复
skill_conflicts 兰台·议 两两比对,只报可疑与证据

安装与启用

官方安装命令(来自 README):

dsh plugin install dsh-lantai

或在 profile 中增加一行:

- id: lantai
  name: 'dsh-lantai'
  config:
    skillRoot: '~/.dsh/skills'
    allowReplace: false
    nudge: true

package.json 标明运行环境为 Node >=20.11,许可证为 MIT;当前资料中的版本号为 0.2.1。

典型用法

  1. 执行上述安装命令,或写好 profile 后启用插件。
  2. 在会话中让 agent 对你的 skill 库做体检,例如 README 中的说法:问一句「体检一下我的 skill」,根据诊录处理矛盾、缺口、逾期与缺验项。
  3. 需要入册新经验时,走 skill_distill,确保通过形状、实质、安全、唯一四类核验。
  4. 用 skill_catalog、skill_audit、skill_attest 维护勘程;冲突排查用 skill_conflicts;淘汰用 skill_retire 并填写归档原因。

适用场景与注意

适合谁:长期在 DSH 中积累 skill、希望库内矛盾与「静默误导」能被点名,并愿意用勘程与归档代替无限追加的开发者或团队。

安全边界(README 明示):兰台可约束「未经核验的 skill 写入」「矛盾未被察觉」等路径,但不能阻止 agent 用 shell 直接写 ~/.dsh/skills,也不能阻止蓄意绕过核验;过期 skill 仍会被注入,只能靠勘程提醒。插件对比 sandbox 内 agent 拥有写入工作区之外的权限,安装前请阅读 GitHub 源码 与 MIT 许可证,确认与自身安全策略一致。

DSH 生态奉行「一切皆插件」;社区目录站点与 DeepSeek / 幻方无官方从属关系,本文仅以公开 README 与仓库元数据为准。

链接

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye