# Grillme for DSH

苏格拉底式深度访谈、方案压力测试，以及可追溯的 Markdown 交接。它是 DSH
bundle，也带有 Codex / Claude Code 可用的便携 `SKILL.md`。

Grillme 不替你回答，而是一次只问一个关键问题；顺着矛盾、隐含假设和风险继续
追问，直到你把想法或方案说清楚。

## 在 DSH 中使用

```text
/grillme 我想做一个本地优先的代码评审助手
```

也可以直接说：

- `grill me on this design`
- `盘问我这个方案` / `把需求问清楚` / `挑战我的方案`
- `допроси меня` / `прожарь` / `интервью`

DSH 会通过 `ask_user_question` 显示选择题，并保留自由输入。模型也可以根据
描述自动加载这个 skill。

## 功能

- **一次一个问题**：每次调用只传一个 `questions` 项，2–4 个真实选项。
- **两种模式**：模糊想法用 Explore 波浪式访谈；已有方案用 Stress-test
  决策树逐支追问。
- **19 个分析透镜**：战略、系统、心理、反方视角，每个都带具体问法。
- **先查再问**：能通过代码、文档、测试确认的事实，自己查并引用路径。
- **假设台账**：每轮区分 `[verified]` 和 `[assumed]`。
- **风险变问题**：总结中的每个风险都要变成下一轮的具体问题。
- **覆盖检查**：收尾前必须问“还有遗漏吗？”，除非你明确叫停。
- **决策摘要**：事实、决策、假设、风险、开放问题、下一步。
- **确定性交接**：你说“保存/导出”时，`grillme_handoff` 会写出
  `grillme-plan-YYYY-MM-DDTHH-MM.md`，包含原始目标、逐条决策、开放问题和
  “人的决策就是约束”的交接规则。默认不覆盖已有文件；同名默认文件会自动加
  数字后缀，显式文件名冲突时会拒绝，除非传 `overwrite: true`。
- **只读访谈**：访谈期间不改文件、不写代码；唯一的写操作是你要求的交接文件。
- **多语言**：跟随你的语言，内置中英俄触发词。

## 安装

本机已安装到 `desktop` profile。仓库本身不绑定某个绝对路径；把包目录
（包含 `package.json` 的目录）链接进 profile 即可。

重新安装：

```text
plugin_manager install_bundle
  target: <dsh-grillme 目录的绝对路径>
```

或：

```powershell
cd path\to\dsh-grillme
dsh plugin --profile desktop add link:.
```

## 兼容性

- **DSH**：`.dsh` bundle，注册 runtime skill + `grillme_handoff` 工具。
- **Codex**：`.codex-plugin/plugin.json` + `skills/grillme/SKILL.md`；问题工具用
  `request_user_input`。
- **Claude Code**：`.claude-plugin/plugin.json` + `commands/grillme.md`；问题工具用
  `AskUserQuestion`。

可移植版本只依赖标准 `SKILL.md` 和宿主的问题工具。没有 `grillme_handoff` 时，
skill 会回退到普通文件写入，并保持同样的 Markdown 结构。

## 文件

```text
dsh-grillme/
├── lib/index.js               # 注册 skill 和 handoff 工具
├── skills/grillme/SKILL.md    # 唯一的便携指令源
├── commands/grillme.md        # Claude Code 斜杠命令
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── locale/{en,zh,ru}.json
├── icon.svg
├── cordis.patch.yml
└── README.md / README.zh.md
```

## 来源与许可

独立改编自三个 MIT 项目：Jekudy/grillme-skill、Matt Pocock 的 grill-me、
idanlo/grillme。详见 [NOTICE](NOTICE) 和 [LICENSE](LICENSE)。

MIT License.