OpenSenseNova/SenseNova-Skills / skills/sn-deep-research
sn-deep-research
Unverified用于用户请求深度研究、系统性研究、竞品分析、方案对比、趋势分析或事实核查时。**遇到以下任一情况就主动使用本 skill,不要自行搜几条就回答**:①用户出现触发词:深度研究 / 深度调研 / 深入研究 / 全面研究 / 系统研究 / 调研 / 调查 / 尽调 / 行业研究 / 市场研究 / 竞品分析 / 政策研究 / 技术研究 / 趋势研究 / 事实核查 / 写一份研究报告 / 调研报告 / 深度报告 / research / deep research;②请求需要跨多来源取证、多维度对比、交叉验证才能给出可靠结论;③用户要求产出报告、白皮书、行业分析或尽调文档;④话题涉及最新政策/市场/产品/价格/法规,需要系统核查。无核验要求的简单常识问答不使用。模糊或宽泛的"研究/了解一下 X"也优先触发。仅不用于:一句话摘要、已给定单一来源的整理、纯文字润色改写。
schemas/outline.schema.md
View on GitHub# 报告编排字段契约
报告编排阶段的字段契约。最终产物由有序的 `content_units[]` 组成。`paradigm` 表示内容推进方式,`organization_decision` 表示核心信息的承载结构。请求级 `format` 由 payload 传入,不复制到 `outline.json`。
## 文件位置
```text
{report_dir}/outline.json
{report_dir}/content_units/{unit_id}.evidence_subset.json
{report_dir}/content_units/{unit_id}.md
```
## 顶层结构
```json
{
"paradigm": { "main": "comparison", "secondary": "evaluation" },
"depth_level": "deep_analysis",
"global_arc": "从用户的选择问题出发,先统一比较口径,再用现有证据呈现差异、冲突和适用边界,最后给出有条件的判断。",
"organization_decision": { "...": "见下文" },
"L0_draft": { "...": "见下文;也可以为 null" },
"style_contract": { "...": "见下文" },
"content_units": [ "..." ],
"claim_routing_table": { "...": "见下文" },
"scan_summary": { "...": "见下文" }
}
```
| 字段 | 类型 | 说明 |
|---|---|---|
| `paradigm` | 对象 | 内容推进范式,不决定产物结构 |
| `depth_level` | 枚举 | `overview` / `deep_analysis` / `expert_level` |
| `global_arc` | 字符串 | 非空的全文方向和证据边界,不设置字符数限制 |
| `organization_decision` | 对象 | 证据完成后的结构决定 |
| `L0_draft` | 对象 / `null` | 是否存在由 `opening_summary` 决定 |
| `style_contract` | 对象 | 体裁、语气、术语和引用约定 |
| `content_units` | 数组 | 1–20 个有序交付单元 |
| `claim_routing_table` | 对象 | 每个被引用断言的唯一主归属与可选次级引用 |
| `scan_summary` | 对象 | 规划器扫描证据后得到的可审计摘要 |
## 结构示例
```json
{
"reader_task": "让采购负责人按同一口径比较三个方案,并识别在不同约束下的适用边界",
"primary_unit_type": "matrix",
"supporting_unit_types": ["callout", "narrative"],
"opening_summary": "recommendation",
"toc": false,
"numbered_headings": false,
"evidence_fit": "现有证据对三个对象覆盖同一组指标,适合用矩阵承载主体;分歧和口径限制由 supporting units 解释。"
}
```
### 内容单元类型
基础枚举:
- `narrative`:连续论述。
- `matrix`:实体乘维度的二维比较。
- `timeline`:按时间或阶段组织的事件链。
- `checklist`:逐项核对状态、要求或完成度。
- `scorecard`:按标准给出等级、分数或判断。
- `qa`:独立问题与回答。
- `callout`:关键事实、冲突、缺口或限制。
- `diagram`:流程、因果、关系或系统结构。
- `custom`:用户定义的其他结构;必须通过 `render_contract.instructions` 说明。
`supporting_unit_types` 是去重数组,可为空;`opening_summary` 取 `none|findings|recommendation`。`toc` 与 `numbered_headings` 必须由已确认形式决定,不能使用报告式默认值。
## `L0_draft`(L0 草稿)
- `opening_summary=none` 时,`L0_draft` 必须为 `null`。
- `opening_summary=findings|recommendation` 时,`L0_draft` 必须存在。
```json
{
"headline": "三个方案的最优选择取决于规模门槛与部署约束",
"key_findings": [
"方案甲在大规模负载下成本最低,但前期部署与迁移要求最高",
"方案乙在中等规模下保持成本和交付速度的平衡,证据覆盖最完整",
"方案丙适合快速启动,但长期成本与扩展性数据仍存在明显缺口"
],
"abstract_visual": {
"form": "comparison-table",
"data_refs": ["d1.c1", "d2.c1", "d3.c1"]
}
}
```
约束:`headline` 必须非空;`key_findings` 保持 3–5 条且每条非空;`abstract_visual` 的事实型 `data_refs` 必须是有效的断言 ID,并进入内容单元路由。自然语言字段不设置字符数限制。
## `style_contract`(样式契约)
```json
{
"register": "executive_memo",
"voice": "declarative_executive",
"terminology": {
"preferred": {
"总拥有成本": ["TCO", "全周期成本"]
}
},
"citation_style": "footnote"
}
```
枚举:
- `register`:`research_brief|academic|executive_memo|industry_report|policy_analysis`
- `voice`:`neutral_analytical|hedged_scholarly|declarative_executive|opinionated_supported`
- `citation_style`:`footnote|inline`
## `content_unit`(内容单元)
```json
{
"id": "u1",
"type": "matrix",
"role": "primary",
"title": "三个方案的核心指标与适用边界",
"reader_task": "按一致口径比较成本、交付、扩展性与主要风险",
"word_budget": 900,
"lead": "三个方案没有脱离场景的统一最优解;规模门槛和交付约束会改变排序。",
"render_contract": {
"mode": "markdown_table",
"show_heading": true,
"schema": ["方案", "成本", "交付周期", "扩展性", "适用边界"],
"instructions": "用一张主矩阵承载所有同口径结果;每格只写结论和必要引用,口径差异放表注。"
},
"elements": [
{
"id": "e1",
"label": "方案甲",
"purpose": "呈现方案甲在统一指标下的结果与限制",
"evidence_refs": [
{ "claim_id": "d1.c1", "role": "primary_support" },
{ "claim_id": "d1.c2", "role": "counter" }
],
"writing_context_refs": ["d1.w1"]
}
],
"evidence_subset": ["d1.c1", "d1.c2"]
}
```
### 通用字段
| 字段 | 约束 | 说明 |
|---|---|---|
| `id` | `^u\d+$` | 内容单元的唯一 ID |
| `type` | 内容单元枚举 | 信息语义,不强制具体 Markdown 渲染方式 |
| `role` | `primary|supporting` | 主体或补充结构 |
| `title` | 非空字符串 | 可展示标题;是否显示由渲染契约决定。`numbered_headings=true` 且显示标题时,标题本身必须带稳定序号 |
| `reader_task` | 非空字符串 | 读者使用该内容单元完成什么任务,不要求写成问句 |
| `word_budget` | 50-3000 | 包含表格、列表和图中可见文字的粗略预算 |
| `lead` | `null` 或非空字符串 | 需要先给结论时使用;结构件不需要开场时为 `null` |
| `render_contract` | 对象 | Markdown 形态和字段契约 |
| `elements` | 1–20 项 | 内容单元内的行、问题、事件、检查项、论点或其他可执行元素 |
| `evidence_subset` | 0–30 个断言 | 写作智能体可见的事实边界;仅表达缺口的内容单元可以为空,但必须路由写作上下文 |
### 渲染契约
```json
{
"mode": "prose|markdown_table|ordered_list|checklist|qa|callout|mermaid|mixed|custom",
"show_heading": true,
"schema": ["字段或列名"],
"instructions": "非空的具体渲染约束"
}
```
- `mode` 与 `type` 不做硬编码映射。`timeline` 可渲染为表格、列表或 Mermaid;`investigation` 也可以使用 `diagram` 或 `narrative`。
- `schema` 是 0–20 个去重字段名。矩阵可以填写列名,`timeline` 可以填写事件字段,`narrative` 可以留空。
- `instructions` 必须说明本内容单元如何承载主要信息,不能只写“按要求输出”。
### 元素与证据边界
每个元素:
- `id`:内容单元内唯一,匹配 `^e\d+$`。
- `label`:非空字符串。
- `purpose`:非空字符串。
- `evidence_refs`:0–10 条,每条包含合法的 `claim_id` 和叙事角色。为空时,`writing_context_refs` 必须非空,并且只能表达有记录支撑的证据缺口。
- `writing_context_refs`:可选,0-20 个 `dN.wM`。
`evidence_refs[].role` 沿用:`primary_support|supporting_context|quantifier|counter|reference_only`。
边界是硬约束:
1. 单个元素最多包含 10 个证据引用;断言与写作上下文不得同时为空。
2. 单个内容单元的 `evidence_subset` 最多包含 30 个去重断言。
3. `evidence_subset` 必须与所有 `elements[].evidence_refs[].claim_id` 的去重并集完全相同。
4. 写作智能体只能读取和引用自己的证据子集,不得从其他内容单元或完整证据中补充材料。
## `claim_routing_table`(断言路由表)
```json
{
"d1.c1": {
"primary": "u1",
"secondary": [
{ "unit": "u3", "role": "supporting_context" }
]
}
}
```
- 每个进入任一 `evidence_subset` 的断言必须有且只有一个主内容单元。
- 主内容单元必须实际在元素中使用该断言。
- 次级角色只能是 `supporting_context|reference_only`,以避免在多个内容单元中重复展开。
- 路由键集合必须精确覆盖所有内容单元引用的断言;不允许存在未使用的路由项。
## `scan_summary`(扫描摘要)
```json
{
"totals": { "claims": 18, "sources": 12, "primary_ratio": 0.67 },
"topic_clusters": [],
"conflicts": [],
"key_entities": [],
"timeline_density": [],
"gaps": [],
"reader_task_signal": {
"panorama": 0.05,
"comparison": 0.55,
"investigation": 0.05,
"timeline": 0.05,
"evaluation": 0.25,
"forecast": 0.05
}
}
```
`reader_task_signal` 只为六种内容范式评分,不增加结构类型得分,也不用于自动映射 `primary_unit_type`。结构决定写入独立的 `organization_decision`。
## `evidence_subset.json`(证据子集)
```json
{
"content_unit_id": "u1",
"claims": [
{
"id": "d1.c1",
"text": "...",
"kind": "factual",
"polarity": "neutral",
"topic_tag": "cost",
"narrative_role": "primary_support",
"evidence": ["..."]
}
],
"writing_context": [],
"sources": []
}
```
输出规则:
- `content_unit_id` 必须存在于 `outline.content_units`。
- `claims`、`writing_context` 与 `sources` 中的对象必须具备合法字段;传入原始证据时,断言和写作上下文 ID 必须存在。
- 子集必须包含本内容单元元素实际引用的断言和写作上下文;额外对象不会仅因重复索引关系而直接判错。
- `sources` 必须覆盖断言和写作上下文引用的来源 ID。
## 最小示例
```json
{
"paradigm": { "main": "evaluation", "secondary": null },
"depth_level": "overview",
"global_arc": "围绕用户需要作出的选择,按统一标准核对关键证据、相反信息和适用边界,给出受证据强度约束的判断。",
"organization_decision": {
"reader_task": "快速核对方案是否满足关键条件,并看到每项判断的证据边界",
"primary_unit_type": "checklist",
"supporting_unit_types": [],
"opening_summary": "none",
"toc": false,
"numbered_headings": false,
"evidence_fit": "现有证据逐项对应明确条件,适合直接核对;无法确认的项目可以保留未知状态而不扩写成章节。"
},
"L0_draft": null,
"style_contract": {
"register": "research_brief",
"voice": "neutral_analytical",
"terminology": { "preferred": {} },
"citation_style": "footnote"
},
"content_units": [
{
"id": "u1",
"type": "checklist",
"role": "primary",
"title": "关键条件核对",
"reader_task": "逐项确认关键要求是否满足以及证据是否充分",
"word_budget": 500,
"lead": null,
"render_contract": {
"mode": "checklist",
"show_heading": true,
"schema": ["条件", "状态", "依据", "限制"],
"instructions": "每项只给满足、不满足或证据不足三种状态,并在同一项内附引用和限制。"
},
"elements": [
{
"id": "e1",
"label": "条件甲",
"purpose": "核对条件甲是否满足并呈现证据限制",
"evidence_refs": [
{ "claim_id": "d1.c1", "role": "primary_support" }
],
"writing_context_refs": []
}
],
"evidence_subset": ["d1.c1"]
}
],
"claim_routing_table": {
"d1.c1": { "primary": "u1", "secondary": [] }
},
"scan_summary": {
"totals": { "claims": 1, "sources": 1, "primary_ratio": 1.0 },
"topic_clusters": [],
"conflicts": [],
"key_entities": [],
"timeline_density": [],
"gaps": [],
"reader_task_signal": {
"panorama": 0.0,
"comparison": 0.0,
"investigation": 0.0,
"timeline": 0.0,
"evaluation": 1.0,
"forecast": 0.0
}
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |