用途：运行 /jackin-dev:research <slug>，针对一个需要深入调查的问题产出独立的多页研究报告，发布在 jackin' 文档站。报告由 brief（prompt.mdx）驱动：先撰写 brief，再执行。它负责收集与综合证据（网络 + 代码库），不替代产品设计决策。参考实现位于 jackin' 仓库的 docs/content/docs/research/token-optimization-research/。
不适用：路线图事项的设计决策应使用 /jackin-dev:brainstorm；快速查询直接用 deep-research 或 Explore，无需 dossier。
参数：--brief-only 仅撰写 prompt.mdx 后停止，之后用 /goal Follow <brief> 执行；--in-roadmap 将发现内联存入路线图事项而非独立 dossier（仅限小研究）；--web-only / --codebase-only 限制只用一种取证方式。
输出布局（默认独立文件夹）：docs/content/docs/research/<slug>/ 下含 meta.json（含 title、defaultOpen:false、pages 的侧边栏顺序）、index.mdx（落地页：头条数字、阅读指南、分级列表）、prompt.mdx（所运行的 brief，附 /goal 运行行）、编号章节 NN-*.mdx（00 摘要、01 基础、10-20 专题、30+ 综合）以及可选的 tools/（脚本，含自己的 meta.json 与 index.mdx）。同时把 <slug> 加入父级 docs/content/docs/research/meta.json 的 pages。大研究用独立文件夹（默认），小研究用 --in-roadmap。
流程：① 范围/brief，从主题或路线图事项起草或加载 prompt.mdx（任务、章节列表、证据规则）；② 取证，网络用内置 deep-research，代码库用 Explore/grep，外部论断须带来源 URL，本地数字须带方法；③ 写作，index.mdx 与编号章节按每项技术的固定记录结构撰写，复现脚本放 tools/；④ 接入侧边栏，创建/更新 dossier 的 meta.json 与父级 research/meta.json；⑤ 文档门禁与提交，在 docs/ 下运行 bun 文档门禁（build、check:repo-links、tsc --noEmit、test），以 docs(research): 提交并推送。
常见错误：强行套用 Problem/Why/Design 结构（dossier 是自由形式，不是路线图事项）；做出设计决策（那属于 brainstorm）；外部论断无来源或本地数字无方法；meta.json 的 pages 与磁盘文件不同步。
工具：cargo xtask research scaffold <slug> 创建文件夹与 meta.json；cargo xtask research check 校验 pages 与磁盘一致。执行通常经由外部 /goal Follow <brief> 进行。