dsh-spec-mode

dsh-spec-mode

DSH 插件：由模型主导的增量访谈，把用户逐步浮现的需求固化成开发规范与项目文档。

这份文件回答一个问题：这个插件做什么、怎么用、改它之前要知道哪几条规矩。

• 入口：仓库根目录的入口模块，一个接收插件的上下文、把各种能力挂上去的装配函数。
• 依赖：只用到 Node 自带的加密、文件、路径三类模块。不装任何宿主运行时包：只靠 profile 自身解析，不会装出第二份宿主运行时。
• 安装形态：以链接方式挂进 web profile，加载器的行为名是 include:spec-mode。
• 产出文档只写结论与硬事实，不解释：删掉一句话读者照做也不出错，就删——动机、背景、权衡、意义、 影响、被否决方案不写，开场不铺引言、结尾不做总结（纯事实的清单除外）。信息密度极高：一行一个结论， 能进表格就进表格，同一件事只说一次。外行看得懂靠短句与实例，不是靠解释——术语不解释。代码能不出就 不出，只在读者要照着做时才给，并且要跟着复现步骤。
• AGENTS.md 只放文档索引与开发规范规则：不写现状、进度、待办、下一步、里程碑、变更记录。

用法

进入访谈与退出访谈两条命令：

/spec [初始想法]
/spec off

裸 /spec 只切模式，不提交任何消息：访谈从用户真正写下的东西开始——/spec 后面的想法， 或他随后发的第一条普通消息。

访谈结束时不需要用户手动退出：模型会弹一个确认框，让用户选「退出并落盘」或「继续访谈」。访谈 期间工作树只读，唯一可写目标是项目文档目录里的那份访谈草稿。

规则

• 改投影状态字段或折叠语义时，必须同时把状态版本号加一。 否则持久化缓存里的旧行会被前向 折叠成垃圾。
• 裸 /spec 不得合成消息。 命令面本身不产生模型消息；补一条「起轮」消息等于替用户开题。 访谈必须由用户写下的内容触发。
• 不要在命令处理里读「有效状态」来回答「这条命令进来之前是什么状态」。 命令记录在处理器 之前入日志，那个问题只能问已提交状态。
• 图标用显式颜色，不要跟随当前色。 图标以数据地址渲染，拿不到宿主样式里的颜色。
• 状态折叠对无关事件必须返回同一个状态引用，否则投影的增量机制失效。
• 不引宿主包。 需要宿主工具时按等价实现内联。
• 六条文档规则要跟着落盘文件传下去（自举）。 写法与判据分两处维护：写法在访谈协议里，写入 时的提醒判据在软约束模块里；改判据要同时改写法说明，否则模型只被提醒、不知道该怎么写。

文档索引

自测

node selftest.mjs

24 项纯逻辑断言，不需要宿主：草稿锚点、路径判定、投影折叠的全部分支、产出文件的提醒判据。

协议

MIT