dsh-grill-first

DSH（DeepSeek Harness）插件：开工前先刨根问底——把模糊需求问成明确需求，你在对话里点头之后，主任务才开工。

它解决什么问题

AI 助手最常见的失败不是"不会做"，而是"做完了才发现做的不是你要的"。这个插件在任何新任务开工前插入一道需求澄清环节：

1. 模型先把你的任务原文交给 grill_start 判定；
2. 任务模糊（缺目标 / 范围 / 约束 / 验收标准）→ 它按轮追问你，每轮 3 个问题，最多 3 轮，每轮都基于你上一轮的回答继续深挖；
3. 问清后整理成中文四段清单（目标 / 范围 / 约束 / 验收标准），用 grill_confirm 请你确认；
4. 你点"确认，按此开工"→ 本次任务放行；你点"要改"→ 它按你的反馈修订后再来一次；
5. 一句话就能说清的小任务、以及带「直接做 / 跳过提问 / 不用问 / skip」字样的消息，不会被打扰。

严格档位（gateMode: "strict"）下，需求没确认前模型无法执行写文件、跑命令这类变更类操作——从机制上保证"没问清就不许动手"。

安装

装插件前请先退出正在跑的任务。三种方式任选：

方式一：DSH 插件市场（推荐）

在 DSH 设置 → 插件里搜索 dsh-grill-first 一键安装。

方式二：npm 命令行

dsh plugin --profile <你的 profile 名> add dsh-grill-first

方式三：本地包 / GitHub 仓库

dsh plugin --profile <你的 profile 名> add /绝对路径/dsh-grill-first-0.1.1.tgz
dsh plugin --profile <你的 profile 名> add github:InoriMutsumi/dsh-grill-first

装完即生效：本机实测 DSH 的 live profile 会热加载新插件，不需要重启（若你的 profile 是启动式、或列表里没出现，再完全退出 DSH 重开一次）。

使用

装好之后不需要你做什么：它靠两件事自动工作。

• 协议提示段：插件往系统提示里注入一小段中文协议（约 600 字），告诉模型"接到新任务先调 grill_start"。你在系统提示里能看到 【开工前提问协议（grill-first）】 就说明装好了。
• 工具：模型会用这两个工具推进澄清流程。

工具	作用
grill_start	判定任务是否需要澄清；返回 verdict、focus_hints（该问什么）、memory_context（已知偏好，避免重复问）
grill_confirm	把四段式需求清单交给你确认；确认后放行任务，并把确认过的内容写进记忆

想跳过提问时

• 消息里带上「直接做」「跳过提问」「不用问」「skip」中任意一个 → 立刻开工；
• 或者在设置里把 enabled 关掉 / 把 gateMode 调成 off → 整个插件静默。

配置项

DSH 设置界面 → 插件 → dsh-grill-first，共 7 项：

配置	类型	默认	说明
enabled	布尔	true	总开关。关闭后既不追问也不拦截工具
gateMode	off / warn / strict	warn	off 不拦截；warn 只在日志里记录"需求未确认"；strict 未确认前拦截变更类工具
maxQuestionsPerRound	1-6	3	每轮最多问几个问题
maxRounds	1-10	3	最多追问几轮
intensity	gentle / standard / grill	standard	追问力度：只问关键点 / 标准 / 刨根问底
bypassKeywords	字符串数组	["直接做","跳过提问","不用问","skip"]	命中即跳过提问
memoryEnabled	布尔	true	是否启用两层记忆

默认是 warn 而不是 strict：默认档位保证升级插件不会突然卡住你已有的工作流。想要硬门禁请手动切 strict。

怎么改配置

DSH 设置页里的插件条目目前只提供「启用 / 停用」开关（客户端的插件页不渲染第三方插件的配置表单），要改上面 7 项请编辑 profile 的补丁层 cordis.patch.yml：

# <profile 目录>/cordis.patch.yml
- id: dsh-grill-first
  name: dsh-grill-first
  config:
    gateMode: strict          # off | warn | strict
    maxQuestionsPerRound: 3   # 1-6
    maxRounds: 3              # 1-10
    intensity: standard       # gentle | standard | grill
    memoryEnabled: true
    bypassKeywords: [直接做, 跳过提问, 不用问, skip]

改完重启 DSH 生效。只写想改的项也可以，其余项用默认值。

两层记忆

只记录你确认过的内容，不记录对话原文，也不会把需求清单写成文件。

层	位置	内容
全局层	<profile 目录>/grill-first/global.json（不可写时退化到 ~/.dsh-grill-first/global.json）	通用偏好，如"注释一律用中文"
项目层	<工作区>/.dsh/grill-first/memory.json	项目背景、任务历史（任务名 + 需求摘要 + 日期）

下次追问时，grill_start 会把这些内容作为 memory_context 返回，模型就不会重复问你同一件事。

开发

npm install          # 装开发依赖（schemastery 由宿主提供，仅开发期需要）
npm run build        # TypeScript → dist/
npm test             # 构建 + 91 个单测 / 端到端场景测试
node scripts/selfcheck.mjs   # 静态自检：中文 JSDoc、any 用量、需求→代码位置

推送到 GitHub 后 .github/workflows/ci.yml 会自动跑上面那两条（npm ci + npm test）。dist/ 是故意提交的：这样 dsh plugin add github:… 装完即可用，不需要在你的机器上编译。

代码结构：

src/
  index.ts              插件装配入口（工具 + 协议段 + 门禁）
  config.ts             配置归一化（不依赖宿主，可单测）
  configSchema.ts       Schemastery 配置声明（设置界面用，7 项）
  version.ts            从 package.json 读版本号，供 grill_start 返回
  judge/heuristics.ts   任务模糊度判定（纯函数）
  prompt/protocol.ts    注入系统提示的中文协议文本
  tools/grillStart.ts   grill_start 工具
  tools/grillConfirm.ts grill_confirm 工具
  gate/preExecute.ts    变更类工具门禁（tools/pre-execute + 新消息重置）
  memory/store.ts       两层记忆的读写

已知限制

• 门禁只对根 agent（能直接跟你对话的那个）生效；子 agent / 团队成员不拦，否则正常的委派工作流会被卡死。因此委派类工具本身（subagent、workflow、spawn_teammate…）在未确认前也会被拦，防止"派个子代理替自己动手"绕过门禁。
• warn 档位只能"记录不拦截"：DSH 的 tools/pre-execute 事件没有"放行但同时给模型提示"这种返回形态。
• 记忆是本地文件，不含加密；删掉对应 json 即清空。
• grill_confirm 优先走 DSH 的结构化提问通道；该通道不可用时（例如子 agent 内部）会返回 needs_user_confirmation: true，由模型改用内置提问工具兜底。
• 改代码后必须重启 DSH：DSH 加载的是 profile 里那份安装拷贝，而且插件代码改动不会热生效（实测：cordis.patch.yml 里的配置改动是热生效的，包代码不是）。判断运行中的是哪一版：调一次 grill_start，返回里的 version 字段就是当前在跑的版本；看不到 version 说明跑的是 0.1.0 之前的旧代码。
• 跳过关键词里英文按词边界匹配（skip 能命中 skip、Skip this、（skip），但不会命中 skipList、skip_list、bypass-keyword 这类标识符）；中文关键词按子串匹配（直接做 命中 那你直接做好了）。

许可

MIT，见 LICENSE。