guyuefangyuanl/deepseek-better-harness

DeepSeek Better Harness

CI
License: MIT
Node
Zero runtime deps

Better Harness 通过将证据分离为三个相互独立的关注点来审查一个 agent 项目。本仓库将这三个关注点带入 DeepSeek Harness，形式为一个 DSH bundle，注册三个可独立路由的 skill。

安装一次。启用你想要的 lane——你未启用的那些永远不会被注册，因此它们不占用任何路由面和上下文。

非官方。 与 Qoder 或 DeepSeek 无关联、未获其背书、亦非由其发布。这是一个社区对某个边界的移植，而非对产品的再分发——见 NOTICE。

三个 lane

| Lane | 审查对象 | 回答的问题 |
| --- | --- | --- |
| session-evidence | 已授权的会话事实 | agent 在哪里重复了工作、遇到了摩擦，或丢失了反馈回路？ |
| project-readiness | 仓库本身 | 这个仓库是否给 agent 提供了一条清晰的变更路径、有界风险和可执行的验证？ |
| agent-assets | Skills、presets、hooks、tools、MCP config | agent 资产是否可被发现、正确路由、完好无损且归属安全？ |

每个 lane 通过 ctx.skills 恰好贡献一个运行时 skill。根据 DSH 的优先级规则，同名项目级或用户文件系统 skill 仍会覆盖捆绑的运行时 skill。

每个 lane 也是 packages/ 下独立的 npm 包，因此只想要某一个的 profile 可以只安装那一个——见 Install。

为什么选择它而非上游产品

一个 lane，一项职责

Better Harness 回答三个不同的问题，而这三个问题会以三种不同的方式失败。将它们合并为单一的“审查我的项目”skill，正是让这类 skill 模糊到足以误触发的原因。在这里，每个 lane 都是独立的 skill，拥有自己的边界，而 config.lanes 决定一个 profile 究竟注册哪些：

- id: deepseek-better-harness
name: deepseek-better-harness
config:
lanes: [project-readiness]

想要一次就绪性审查，并不会顺带拖入一个会话分析器、一个评分引擎和一个报告渲染器。未知的 lane 名称是启动错误，而不是静默地得到一个更小的 skill 集合。

零运行时依赖

每个包都声明 "dependencies": {}。唯一声明的依赖是你已经拥有的 DSH peer 包。一个 bundle 是 7 个文件、约 7 KB——它为你的 profile 增加一项能力，而不会为你的 lockfile 增加一棵依赖树。

每个 skill 都会说明何时不应触发
三个描述都带有明确的否定条款：

在审查已授权的 DSH 会话事实以查找重复工作、代理
摩擦、缺失的反馈循环或结果证据时使用。请勿使用来读取
未经批准的原始记录、推断隐藏推理、对整个仓库评分，
或检查项目资产。

错误路由是技能层中代价高昂的失败——模型在错误的时刻加载了错误的
技能，消耗上下文，并发生漂移。由于这里的三个通道是刻意相邻的，
否定条款正是防止会话问题牵扯进资产审计器的关键。大多数社区技能只写了
肯定的一半。

证据纪律是一种机制，而非口号

harness-session-evidence 强制将观察到的行为、缺失的证据和
推断分入不同的桶中，并要求至少两次可比较的
出现才能将某事物称为模式——一次出现只是一个候选。

所有三个技能返回的都是证据候选，而非最终的严重性评级或
仓库范围的评分。这不是谦虚：它们不附带收集器，因此
它们无权给出评分。一个看不到证据的技能必须报告
这一边界，而不是编造发现。

验证实际上会安装插件

scripts/validate-packages.mjs 并不检查清单。它 import() 每一个
真实的 index.js，捕获每个文件注册的技能，然后断言包身份、frontmatter、资源路径、描述限制和拆卸。一个
结构上完美但注册失败的包会在这里被捕获，而不是在你的配置文件中。CI 在 Linux 和 Windows 上运行它。

安装

仓库根目录就是该包：其清单声明了
dsh.bundle.patch，因此 DSH 将其视为配置文件层，DSH Hub 也接受它
作为提交。测试基线是 DSH 0.1.0-rc.6。

从某个提交安装

dsh plugin --profile web add "github:guyuefangyuanl/deepseek-better-harness#"

固定一个提交而非分支：这里的技能文本就是产品，你
希望以后能重现这次审查。

从克隆安装

git clone https://github.com/guyuefangyuanl/deepseek-better-harness.git
dsh plugin --profile web add "link:C:/absolute/path/to/deepseek-better-harness"

在 0.1.0-rc.6 上，配置文件会自行协调——一个清单声明了
dsh.bundle.patch 的依赖会被自动追加到 dsh.profile.bundles，
因此无需手动编辑。确认该层已落地：

dsh --profile web --dump-config

如果该层缺失，DSH 会在 stderr 上说明原因：

dsh: warning:  declares no dsh.bundle — installed as a plain dependency,
not a profile layer

选择通道

所有三个通道默认启用。若要只注册其中一部分，请在你的配置文件补丁中
为该包提供一个 config.lanes 列表：

- id: deepseek-better-harness
name: deepseek-better-harness
config:
lanes: [project-readiness, agent-assets]

有效名称为 session-evidence、project-readiness 和 agent-assets。未知名称、空列表或非数组会在启动时失败，而不是静默地注册比你要求的更少的技能。

改为安装单个 lane

每个 lane 也是一个独立包，适用于永远不应路由到另外两个的配置文件：

dsh plugin --profile web add "link:C:/absolute/path/to/deepseek-better-harness/packages/project-readiness"

不要将根捆绑包和某个 lane 包同时安装到同一个配置文件中——该 lane 会被注册两次。

要求

所选配置文件必须已提供 DSH skills 服务以及用户/模型技能界面。此捆绑包不安装任何生命周期脚本：没有 preinstall、install、postinstall 或 prepare，也不会在你的机器上编译任何内容。tarball 中的内容就是运行的内容，CI 会对此进行断言。

验证

无依赖。Node.js 22：

node scripts/validate-packages.mjs
node scripts/pack-dry-run.mjs

两件看起来像 bug 但并非如此的事

parseCanonicalSkill 在所有三个包中逐字重复。 共享辅助函数会让三个可独立发布的捆绑包为了大约三十行解析代码而耦合到一个公共的版本化运行时依赖——并破坏使单包安装成本低廉的零依赖特性。验证器断言每个副本仍产生相同的技能形态。参见设计说明。

发布不是自动化的。 注册表凭据、包所有权、发布标签和社区提交都是外部操作。

边界

- Better Harness 仍然是完整产品：证据收集、对账、评分和渲染。此仓库将其三个证据边界移植为提示级技能，并且从不声称运行了不可用的收集器。
- 这些捆绑包提供提示文本和一个小型加载器。它们不打开端口、不生成进程，也不发起网络请求。参见 SECURITY.md。
- DSH 处于预发布阶段。在声称支持比所声明基线更新的 DSH 之前，请重新运行上述检查。

贡献与安全

CONTRIBUTING.md 涵盖检查项和不可协商的规则。SECURITY.md 涵盖信任边界以及如何报告漏洞。

作者与许可证

由 @guyuefangyuanl 创建并维护。

MIT。参见 NOTICE 了解署名和非官方状态声明。