dsh-project-brief:把项目分析文档收进输入框面板,并用断言判卷

前言

做智能体开发时,项目分析文档是高频产物:读一遍代码,输出文档类型、工程类型、事实台账和结论。问题在于文档质量没有客观标准。同一份「项目分析」,模型写出来之后没人能判断它漏了什么、错在哪:事实台账是否与代码一致、工程类型判断是否站得住,都靠人眼复看,代价高且不一致。

dsh-project-brief 针对的就是这个环节。它是 DeepSeek Harness(DSH)的客户端插件,由 xxuucc 维护,在输入框上方加一块面板,并把项目分析文档的产出改成带断言的形式,让文档可以被检查而不是被信任。

这是做什么的

一句话:把项目分析文档的生成位置前移到输入框上方,并为文档内容加上可判卷的约束。

维护者:xxuucc。分类:客户端。目录页标注星标为 0(按 SkillHub 目录页数据)。

Source: https://www.skillhub.cn/plugins/xxuucc/dsh-project-brief

核心功能

输入框上方面板

插件在输入框上方增加面板区域。按插件简介,项目分析文档的生成入口位于该面板内,而不是在对话过程中临时调用某个命令。

来源:SkillHub 目录页插件简介,原文为「输入框上方面板 + 可判卷的项目分析文档生成」。

可判卷的项目分析文档

按目录页简介,插件产出的项目分析文档包含两部分:

1、事实台账:把文档中出现的事实性内容逐条登记,形成可逐条核对的清单。
2、18 项断言:文档需要满足 18 项可判定的断言,用于判卷(即逐项检查是否成立)。

「判卷」在这里指对断言逐项做真/假判定。资料中没有给出断言的具体条目,也没有给出判卷的输出形式,因此这 18 项断言的内容需要以插件源码为准。

文档类型与工程类型可扩展

简介同时说明文档类型与工程类型是可扩展的,即插件不把分析范围固定在单一文档类型或单一工程类型上,允许自行扩充。资料中没有列出已内置的文档类型或工程类型,也没有给出扩展的配置方式。

安装与启用

目前公开资料中没有可用的安装命令。

SkillHub 目录页以前端渲染为主,抓取不到正文;GitHub 仓库页与 raw README 在本次写作时均无法打开,因此无法从资料中核对安装命令。按照本文的约束,不凭插件名称拼接 dsh plugin add 一类命令。

启用前请自行核对:

# 待核实:该命令未在已抓取资料中出现,请以插件源码或目录页实际说明为准

另外需要注意,插件运行在当前 dsh 进程权限之下。安装前应先查看源码,确认插件的声明范围与许可证(资料中未给出许可证信息),再决定是否启用。

典型用法

按目录页简介,插件的产出物是一份含事实台账与 18 项断言的项目分析文档。因为资料中没有 README 与示例命令,下面只描述可用部分,不补全具体调用方式。

1、在输入框上方的面板中发起项目分析文档生成。具体的触发方式资料中没有说明。
2、拿到文档后,检查事实台账是否逐条对应到代码中的事实。
3、对 18 项断言逐项做真/假判定,未通过的项即判卷不通过项。

断言条目和判卷的具体执行方式,同样需要以插件源码为准。

适用场景与注意

适合以下情况:

1、需要对智能体产出的项目分析文档做客观检查,而不是人工复看。
2、文档类型或工程类型超出插件内置范围,愿意自行扩展。
3、愿意先读源码再启用插件,而不是直接安装第三方客户端插件。

需要注意:

1、以插件当前 dsh 进程权限运行。插件能读取的文件与能执行的操作,取决于启动 dsh 时所用的用户与目录权限。
2、安装前先检查源码与许可证。本插件源码位于 https://github.com/xxuucc/dsh-project-brief ,本文写作时无法访问该页面,无法确认许可证与实现细节。
3、SkillHub(skillhub.cn)是独立的社区目录站点,与 DeepSeek / 幻方无官方从属关系,因此这不是官方应用商店,目录页信息仅作参考。
4、18 项断言的条目内容可能在后续版本中变化,判卷前请确认与当前源码一致。

小结

dsh-project-brief 的价值不在「多生成一份文档」,而在把项目分析文档的生成入口固定到输入框上方的面板,并用事实台账加 18 项断言让它可以被逐项判定。如果你正被项目分析文档的可靠性问题困扰,可以从源码确认断言条目与扩展方式,再决定是否采用。

目录页:https://www.skillhub.cn/plugins/xxuucc/dsh-project-brief
源码:https://github.com/xxuucc/dsh-project-brief

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

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

小夜