3d-deep-research
3D Deep Research(立体分析法)是一个证据链驱动的深度研究 Skill。用于对产品、公司、技术、概念、人物、行业、竞品、市场或复杂事件进行系统调研,并交付可追溯、可验证的 Markdown、HTML 与 PDF 报告。核心把 X 轴时间线因果链、Y 轴关键截面力场、Z 轴内部机制拆解汇合为机制判断,并支持问题驱动的图表配置与分层降密度写作。用户提到 deep research、深度研究、系统调研、竞品分析、市场研究、尽职调查、行业研究、来龙去脉、证据链或正式研究报告时使用。它不是 3D 建模、3D 渲染、CAD 或图形设计 Skill;简单名词解释、纯新闻摘要、短篇观点、仿写和无需证据链的简答不使用。
jeffy-Peng · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add jeffy-Peng/jeffy-skills --skill 3d-deep-research技能说明
name: 3d-deep-research description: | 3D Deep Research(立体分析法)是一个证据链驱动的深度研究 Skill。用于对产品、公司、技术、概念、人物、行业、竞品、市场或复杂事件进行系统调研,并交付可追溯、可验证的 Markdown、HTML 与 PDF 报告。核心把 X 轴时间线因果链、Y 轴关键截面力场、Z 轴内部机制拆解汇合为机制判断,并支持问题驱动的图表配置与分层降密度写作。用户提到 deep research、深度研究、系统调研、竞品分析、市场研究、尽职调查、行业研究、来龙去脉、证据链或正式研究报告时使用。它不是 3D 建模、3D 渲染、CAD 或图形设计 Skill;简单名词解释、纯新闻摘要、短篇观点、仿写和无需证据链的简答不使用。
3D Deep Research
把研究对象放进“时间—力量—机制”三维坐标:X 轴解释它如何走到今天,Y 轴解释关键时刻哪些力量同时作用,Z 轴解释关键力量为何这样行动。三轴交汇必须产出新的机制判断,而不是摘要。
默认交付完整 Markdown、HTML 和 PDF。若用户明确缩小范围,按其要求降级;不要把普通问答扩写成长报告。
必读资源
执行完整研究前,按以下顺序读取:
- 始终读取 references/evidence-protocol.md,建立来源账本和 Claim 账本。
- 始终读取 references/xyz-method.md,执行 X/Y/Z 与交汇分析。
- 根据对象类型读取 references/object-adapters.md 的对应部分。
- 需要图表或 PDF 时读取 references/visual-guidelines.md,并叠加 references/chart-allocation.md 的问题驱动图表配置规则(冲突时以补丁为准)。
- 写作前读取 references/readability-style.md:正文去术语、限定语集中化、问句标题;严谨性全部保留在附录,不删一个字。
- 写作时复制 assets/report-template.md,不要重新发明报告结构;章节标题措辞按补丁规则人话化,章节顺序与数量不变。
执行流程
阶段 0:确认研究设定
记录研究对象、对象类型、用户决策问题、特别关注点、时间基准、范围边界和交付要求。对象或决策问题会显著改变结论时最多追问一次;其余情况直接开始。
研究设定必须落盘为文件:复制 assets/research-contract-template.md 为 research-contract.md,填入全部字段并写入深度档位(见下)。契约是后续所有阶段的基准,也是“研究完才发现问错了问题”的止损点;用户确认过的契约照抄,未确认的假设在契约里标注“未确认”。
深度档位(默认 standard,用户没有明说时在契约中注明默认选择):
| 档位 | 来源数 | load-bearing Claim | 正文规模 | 图表 | 审计强度 |
|---|---|---|---|---|---|
quick | 8–12 | ≤6 | 2,000–5,000 字 | 0–2 张 | 全部数字 + 全部结论句 |
standard | 15–25 | ≤12 | 5,000–9,000 字 | 2–6 张 | 全部数字 + 50% 随机 load-bearing |
deep | 25–40 | ≤20 | 9,000–15,000 字 | 4–8 张 | 全部 load-bearing |
涉及“最新、现在、最近”时必须联网核实,并记录发布日期和访问日期。输出不要写入系统目录;使用当前项目的 output/,没有项目时使用用户可写的 Documents/Research/<slug>/。
阶段 1:建立检索地图
先写三组问题:
- 必须确认的事实;
- 需要验证的因果或机制;
- 主动寻找的反向证据、替代解释和失败案例。
检索地图必须落盘:复制 assets/retrieval-map-template.md 为 retrieval-map.md,把三组问题展开为检索方向,并随着检索推进更新“已检索来源 / 状态 / 关联 Claim”三列。这张表同时是阶段 2 账本的检查表——每个承重问题都必须在账本里有对应来源或显式标注“未解决”。
按领域选择来源,不绑定具体搜索工具:
| 领域 | 优先来源 |
|---|---|
| 产品与公司 | 官方文档、更新日志、财报/监管披露、定价与招聘变化、创始人或管理层原话 |
| 技术与学术 | 原始论文、会议版本、标准、官方技术文档、代码与 issue;arXiv 仅在相关时使用,并标注是否经过同行评审 |
| 法律与政策 | 法规原文、监管机构、法院文件、正式咨询材料 |
| 市场与用户 | 可观察指标、应用商店/社区长帖、客户案例、流失或失败反馈;个别评论不能代表总体 |
| 人物与事件 | 当事方材料、同期记录、可靠传记/报道、公开行为与利益结构 |
阶段 2:建立来源与 Claim 账本
直接在 report.md 附录 A2 维护 Claim 账本。为来源分配稳定 ID(S01、S02),为承重判断分配 Claim ID(C01、C02)。
把“来源出处”和“证据作用”分开记录,不使用旧版混合分级。每条承重判断必须写明支持来源、反向材料、独立性、置信度、资料缺口、反证条件、时效期和复查状态。置信度按 references/evidence-protocol.md 的「置信度标定」取锚点值,不凭感觉;时效期按 Claim 类型设置。
完成 Claim 账本前不要写正式正文。
阶段 3:执行证据门控
按 Claim 类型应用不同门槛:
- 事实判断:一条可核验的一手记录,或两条真正独立的可靠二手来源。
- 因果判断:事实节点 + 行为证据 + 独立语境解释;缺一项时降为“暂定解释”。
- 机制判断:当事方材料或行为证据 + 独立解释 + 至少一个替代解释。
- 用户/市场判断:可观察指标 + 有边界说明的用户样本,不能从个别评论外推总体。
- 未来判断:关键变量、基准路径、触发信号、替代解释和反证条件必须齐全。
只阻止没有证据支撑的承重判断,不因局部缺口停止整份交付。证据不足时交付“已确认部分 + 资料缺口 + 下一步验证路径”,禁止补写猜测或虚构事实。
阶段 4:执行三轴分析
先写 X 轴,再从 X 轴选择 2-4 个关键截面写 Y 轴,最后只拆 2-5 个真正改变解释的 Z 轴机制。详细写法见 references/xyz-method.md。
每个重要判断在正文使用 [S01] 形式引用来源。三轴交汇必须说明:
- 哪些早期选择塑造了今天;
- 哪些力场加速、延缓或扭转了路径;
- 哪些机制解释了表面叙事解释不了的现象;
- 这个判断最可能错在哪个前提。
阶段 5:选择未来表达方式
不要固定生成一种未来结构。按关键变量的不确定性选择表达形式(基准路径、2×2 情景矩阵,或只列领先指标),判别标准见 references/xyz-method.md 的「未来表达」一节,此处不再重复。
阶段 6:写作与视觉表达
使用 assets/report-template.md。正文保持六个一级章节:
- 核心结论;
- 时间线因果链;
- 关键力场;
- 底层机制;
- 未来走势;
- 结论。
第三章使用“哪些力量改变了路径”等中性标题,不把所有对象强行写成“为什么爆火”。正文通常 5,000-12,000 字,附录 1,000-3,000 字;深度由问题和证据决定,不分别给 X/Y/Z 叠加字数指标。
图表只在能降低理解成本时使用。量化图必须有可靠、可比较的数据;否则使用时间轴、力场图、机制图或矩阵。复杂 inline SVG 只保证在 HTML/PDF 中呈现;发送到飞书前制作去除复杂 SVG 的 Markdown 副本,以 PDF 保存完整图表。
阶段 7:交付前事实审计
结构校验不能证明事实。运行阶段 8 的校验脚本之前,先按 references/evidence-protocol.md 的「归属审计」「数字复核」「摘录存档」执行事实审计:
- 逐句核对:每个带
[Sxx]的承重句子回到来源原文,确认能从原文推出; - 数字复核:正文每个数字回到来源重算(增长率、占比、单位、币种、口径);
- 反向核对:附录 counterevidence 与正文让步句一致,未被删除或降级;
- 按阶段 0 的深度档位确定抽查比例,未覆盖部分显式注明;
- 把审计结果写入附录 A5(引用摘录存档)与 A6(归属审计与数字复核记录)。
事实审计全部打勾后,才允许进入阶段 8 的结构校验与渲染。审计不通过时,改写正文或降级 Claim,而不是改来源账本去“凑对”。
阶段 8:验证、渲染与交付
先运行:
python [skill目录]/scripts/validate_report.py report.md --strict
python [skill目录]/scripts/render_report.py report.md output.pdf --title "研究对象立体分析报告" --engine auto
render_report.py 已内置 linkify 步骤:渲染时自动把 [Sxx] 引用转为指向来源账本的可点击锚点(HTML 与 PDF 均生效),可用 --no-linkify 关闭;linkify_sources.py 仍可对已有 HTML 单独使用。
依赖说明:Markdown 转 HTML 需要 python -m pip install markdown(缺失时回退到 Codex 内置 Node.js + marked);校验 PDF 文本需要 pypdf 或 PyPDF2;PDF 引擎按 --engine auto 自动选择 Chromium 或 WeasyPrint。
渲染后执行两份补丁的交付前自检清单(chart-allocation 第五步、readability-style 规则五),全部打勾后方可交付。
--engine auto 在 Windows 优先使用 Chromium,其他平台优先使用可用引擎;输出目录不存在时自动创建。默认保留同名 HTML。
PDF 生成后必须:
- 检查文件存在、大小和页数;
- 渲染代表性页面,至少检查封面、正文、表格/图表页和末页;
- 确认中文无缺字,图表无裁切/重叠,页眉页脚和首行缩进正确;
- 将最终文件保存在稳定输出目录;可行时复制一份到桌面;
- 用户要求飞书交付时,把在线文档和 PDF 发送都视为完成条件,并分别验证。飞书 Markdown 不依赖复杂 inline SVG。
质量红线
- 不把新闻排列成时间线因果链。
- 不把力量分类表当作 Y 轴。
- 不用心理揣测代替 Z 轴机制。
- 不用媒体转述代替一手事实。
- 不把同一新闻稿的多次转载算作独立来源。
- 不隐藏冲突、样本偏差、访问失败或资料缺口。
- 不生成没有证据口径的数字图。
- 不留下未渲染 Mermaid、模板占位符或无法追溯的来源。
- 不把三轴交汇写成前文摘要。
- 不交付未做归属审计的 load-bearing 结论。
- 不交付未经复核的数字。
- 不把过期证据当“最新状态”使用。
- 不删除反向材料或悄悄降级。