dsh-spec-mode:访谈驱动的需求固化与只读工作树

前言

在 DeepSeek Harness(DSH)里做智能体或项目开发时,需求往往在对话里一点点浮现,却难以及时沉淀成可执行的规范与文档。常见做法是事后整理聊天记录,或边写代码边补文档,容易漏项、口径不一。下面介绍社区插件 dsh-spec-mode(维护者 LMQ00,分类:工作流):用模型主导的增量访谈,把逐步明确的需求固化成开发规范与项目文档;访谈期间工作树只读,避免边聊边改代码带来的漂移。

这是什么

dsh-spec-mode 是 DSH 的工作流类插件。仓库描述为:Spec mode for the DeepSeek Harness: interview-driven requirements capture with a read-only working tree.(package.json 版本 1.5.0,协议 MIT。)

插件通过仓库根目录的入口模块接收 DSH 上下文并挂载能力;运行时仅依赖 Node 自带的 crypto、fs、path,不引入额外宿主运行时包。安装形态为:以链接方式挂进 web profile,加载器行为名为 include:spec-mode。

核心功能

增量访谈与规范产出

访谈由用户真实输入触发,模型在对话中追问、收敛需求,产出面向项目的开发规范与项目文档。产出文档遵循插件内置的六条写作规则:只写结论与硬事实,不写动机与背景铺陈;信息密度高,能表格则表格;AGENTS.md 仅作文档索引与开发规范规则,不写进度、待办或变更记录。

只读工作树与草稿写入

访谈激活后,工作树处于只读状态,一般文件修改会被拦截。唯一允许写入的目标是项目文档目录下的访谈草稿,便于在访谈过程中持续落盘而不动代码树。

进入与退出

  • 进入:/spec [初始想法]
  • 退出:/spec off

裸命令 /spec 只切换模式,不向模型提交任何消息;访谈从用户写在 /spec 后的想法,或随后发送的第一条普通消息开始。结束时模型会弹出确认,用户可选「退出并落盘」或「继续访谈」,通常不必手动执行 /spec off。

安装与启用

官方 README 未给出 dsh plugin add github:… 形式的一行命令,安装以 web profile 链接 + 加载器行为 为准:

  1. 将插件以链接方式挂进你的 DSH web profile。
  2. 在 profile 配置中启用加载器行为 include:spec-mode。

具体 profile 字段名与链接写法以你当前 DSH 版本与 profile 文档为准;安装前建议在 GitHub 仓库 阅读 docs/插件说明.md 与 README.md,并核对 MIT 许可证与源码。

插件在 当前 dsh 进程权限 下运行,安装前应自行审查代码与权限影响。

典型用法

在已启用 spec mode 的会话中:

带初始想法进入访谈:

/spec 我想做一个内部工具,用来汇总各服务的健康检查接口

仅进入模式,等第一条用户消息再开题:

/spec

(随后发送你的第一条普通消息即可开始访谈。)

手动退出模式:

/spec off

维护者在仓库内对纯逻辑模块提供自测(不依赖宿主):

node selftest.mjs

共 24 项断言,覆盖草稿锚点、路径判定、投影折叠分支及产出文件的提醒判据。改投影状态字段或折叠语义时,须同时将状态版本号加一,否则持久化缓存中的旧行可能被错误折叠。

适用场景与注意

适合: 希望在 DSH 对话里系统梳理需求、把结论写成规范与项目文档的团队或个人;需要在访谈阶段禁止改工作树、只允许写文档草稿的场景。

注意:

  • 社区目录 SkillHub 插件页 与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,本文介绍的是社区工作流插件,非官方应用商店条目。
  • GitHub 公开星标数为 0(以目录页/仓库页面当时展示为准),不代表功能完备度,使用前请自行验证。
  • 改插件行为前可查阅仓库内 docs/实现逻辑.md(状态、守卫、提醒挂载)与 docs/交接文档.md(验证清单、宿主升级排查)。

链接

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

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

Xiaoye