| name | research |
| description | 调研与报告。快速报告（检索后直接写）或深度报告（outline→并行深挖→合成）。默认 Markdown；用户要单页/组件版式时用 HTML。用于调研、简报、评估、计划、纪要。 |
| user-invocable | true |
| allowed-tools | web_search web_fetch read write edit grep glob list_directory bash delegate ask_user attach_content bundle_report create_artifact apply_artifact get_current_time |
| metadata | {"version":"2.0"} |
Research
两种模式，先选一个再开干。
| 模式 | 何时 | 流程 |
|---|
| 快速报告（默认） | 主题单一、时效短、不需多对象结构化对比 | 检索 → 写报告 → 交付 |
| 深度报告 | 多对象/多切片、要可续跑、要字段对齐 | outline → 并行 deep JSON → 合成报告 → 交付 |
澄清：最多问 1 次（模式 / 时间范围 / 交付格式）。能默认则默认。
交付
| 形态 | 路径 | 何时 |
|---|
| 对话结论 | — | 用户只要几句话 |
| Markdown（默认文件） | research/<slug>/report.md 或 report/<slug>.md | 需归档、分享、可打开预览 |
| HTML | report/<slug>.html | 用户明确要 HTML / 单页 / 评分卡时间线等组件 |
规则：
- 未指定格式 → 文件用 Markdown。
- HTML 仅在用户要求或组件版式明显更合适时。
- 最终回复 = 路径 + 一句话摘要；不复述全文。
- 文件交付后
attach_content。HTML 须先 bundle_report。
- 禁止把「按字段 key 全量展开」当作主报告。
- 改稿纪律：首次用
write 落草稿；之后补证据/改段落用 edit（精确 old→new），禁止为小改反复 write 整篇覆盖。
快速报告
web_search / web_fetch（必要时 delegate role=research）。不编造来源。- 直接写报告，结构：
# 标题
> as_of / 范围
## 结论
（5–10 行主线）
## 要点
- …
## 数据 / 对比
（表格）
## 风险与下一步
## 来源
- url
- HTML 时用下方组件骨架 +
bundle_report。
attach_content。
深度报告
1. 建骨架
目录：research/<topic_slug>/
outline.yaml
topic: …
topic_slug: …
as_of: "YYYY-MM-DD"
mode: deep
delivery: markdown
items:
- id: a
name: 对象或切片 A
focus: 一句话
execution:
batch_size: 4
output_dir: results
fields.yaml（扁平；宁少勿滥）
fields:
- name: summary
category: 结论
description: 该项核心结论
required: true
- name: evidence
category: 证据
description: 关键事实与数据
- name: sources
category: 来源
description: URL 列表
required: true
事件/简报类：字段控制在 8 个以内；对比档案类可稍多。不要为无关切片硬套同一张 40 字段表。
2. 并行 deep
- 已有
results/<id>.json 则跳过。
- 每批最多
batch_size 个 delegate（role=research），每 item 一个。
- 子任务：检索 → 按 fields 写 JSON → 不确定写
"[不确定] …" 并列入 uncertain → 中文值 → 含 item_id / item_name / sources。
- 校验（路径按实际 skill 位置填写）：
python <skill_dir>/scripts/validate_json.py -f fields.yaml -j results/<id>.json
3. 合成主报告（必须）
读全部 JSON，写给人看的 report.md（或 HTML）：
- 执行摘要（跨 item 去重后的主线）
- 关键表
- 分项要点（每 item 一段结论，不贴字段名清单）
- 风险 / 下一步
- 来源（去重）
JSON 留在 results/ 即可。不要生成「字段 dump」当 report.md。
4. 交付
同「交付」节。
HTML（两种模式共用）
- 禁止读取或粘贴
components.js；bundle_report 会内联。
- 一次
write 写完草稿；小改只用 edit（不要再整页 write overwrite）。
- 草稿含
<script src="./components.js"></script>、<report-container>、report-header、report-footer。
- 禁止自定义样式；
body 仅背景/字体/间距。
- 组件细节见
references/api.md（仅不熟时读）。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>标题</title>
<script src="./components.js"></script>
</head>
<body style="background:#f8f8f8;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif;padding:32px 24px;margin:0">
<report-container>
<report-header badge="调研" date="YYYY-MM-DD" title="标题" summary="一句话结论。"></report-header>
<report-section title="结论">
<report-findings>
<report-finding type="fact">…</report-finding>
<report-finding type="risk">…</report-finding>
<report-finding type="action">…</report-finding>
</report-findings>
</report-section>
<report-footer><span>来源：…</span></report-footer>
</report-container>
</body>
</html>
常用：report-stat-cards / report-stat-card、report-callout、report-decision、表格。
检查清单
不要
- 无必要拆 18 个 item 又共享超大 fields
- 默认上 HTML
- 静默假装完成未通过校验的 deep item
- 报告已存在后仍多次
write 整文件重写（应 edit）
