Sou-Research

Sou-Research 是一个开放式研究编排 Skill，用来把宽泛研究请求转成有来源支撑、能支持决策的研究报告。它适合市场、公司、竞品、产品、技术、政策、开源项目和投资风格研究，也支持输出 Markdown、HTML、PDF、DOCX、PPTX 或对话式结论。

这个项目的核心设计是“先理解，再研究”。默认不会直接大规模搜索和写报告，而是先做少量定向预搜索，生成一份预填好的诊断式任务简报，请用户确认范围、深度、格式和风格，然后再进入完整研究流程。

项目定位

Sou-Research 不是一个搜索脚本，也不是单纯的报告模板。它更像一个可复用的研究工作流：

• 先用少量预搜索建立任务边界
• 明确研究要支持的决策
• 选择研究框架、深度、内容模式和输出格式
• 使用来源等级和 claims 账本管理证据
• 区分事实、推论、建议和弱信号
• 用无品牌风格预设生成正式报告产物
• 在可行时校验报告规格、证据账本和渲染结果

适用场景

适合使用 Sou-Research 的任务：

• 市场或行业研究
• 公司或标的研究
• 竞品比较
• 市场进入分析
• 产品或用户研究
• 技术生态评估
• 政策或监管研究
• 金融、估值或投资风格研究
• 开源项目评估
• 带引用的正式报告
• HTML/PDF/DOCX/PPTX/Markdown 研究产物

不适合的任务：

• 单点事实查询
• 不需要来源的普通聊天
• 不需要结构化分析的简短解释
• 要求复制第三方银行、咨询公司或媒体专有模板的请求

默认工作流

1. brief-first

默认模式。执行者先做少量定向预搜索，目的是理解：

• 当前术语
• 主题边界
• 主要玩家
• 可用来源质量
• 研究可能要支持的决策
• 适合的输出格式和风格

然后输出一份任务简报，让用户确认或修正。

2. direct-run

只有用户明确要求跳过确认时使用，例如：

• direct
• direct-run
• 直接跑
• 不要问
• 不用确认
• 跳过确认

即便直接执行，也仍然需要说明关键假设，并维护证据边界。

第一轮任务简报

Sou-Research 的第一轮不是空白问卷，而是预填式诊断简报。简报通常包括：

• 对请求的理解
• 为什么要做这项研究
• 研究要支持的决策
• 主研究框架
• 辅助视角
• 分析单位
• 比较对象或基准组
• 受众
• 范围
• 纳入和排除主题
• 快速预搜索信号
• 推荐输出格式
• 输出格式选项
• 推荐报告风格
• 推荐内容模式
• 推荐研究深度
• 证据标准和来源计划
• 重要假设
• 剩余模糊点
• 为什么需要确认

这样可以避免研究方向偏离，例如地域错、受众错、比较对象错、报告形态错，或把用户要的核心判断写成形式化套话。

研究深度

深度控制研究工作量和证据覆盖，不控制视觉包装。

模式	适用情况	研究强度	典型输出
short	快速了解、常识校验、判断是否继续	一轮聚焦搜索，抓关键事实和限制	1-3页或简洁对话回答
brief	会前准备、快速决策备忘、早期机会筛选	围绕主决策定向收集和交叉核查	4-8页或高密度备忘
standard	常规研究报告、市场/公司/产品比较	结构化覆盖官方、公司、二手和反证来源	10-20页或完整产物
deep	投资研究、市场进入、战略押注、尽调式研究	多轮研究、三角验证、证伪条件、claims 账本	完整研究包，或更短但证据密度高的核心备忘

deep 不等于堆更多正式章节。它意味着更强的证据标准、更清楚的反证和更明确的“什么会改变结论”。

内容模式

core-content

默认模式。适合用户想看核心内容时使用：

• 论点先行
• 关键证据
• 市场或玩家图谱
• 结构化分析
• 决策含义
• 风险和反论点
• 下一步
• 紧凑来源列表

full-format

适合正式交付：

• 封面
• 范围和方法
• 执行摘要
• 完整结构化正文
• 情景或敏感性分析
• 风险矩阵
• 来源附录
• claims 证据账本
• 必要合规说明

风格预设

Sou-Research 只使用无品牌风格预设，不复制第三方专有模板、标识、水印、免责声明或精确品牌色。

预设	适合	视觉方向
institutional-blue	股票研究风格报告、市场报告、公司备忘	克制蓝灰配色、密集表格、保守标题
gold-accent	战略备忘、宏观笔记、估值简报	黑白基底、低饱和金色强调
consulting-clean	市场进入、战略、运营模型	干净网格、强层级、框架图
academic-neutral	政策、技术、科学、白皮书研究	中性排版、强调方法
venture-memo	创业、市场、产品、融资论点	论点框、市场图谱、风险和里程碑

如果用户要求“摩根士丹利风格”“高盛风格”等具名样式，Sou-Research 会映射到接近的无品牌预设，并明确不会复制专有模板。

输出格式

支持的输出意图：

• 对话
• Markdown
• HTML
• PDF
• DOCX
• PPTX

内置脚本可把 Markdown 渲染为带样式 HTML；当 Playwright 可用时，也可以生成 PDF。

安装

把本仓库作为一个 Codex Skill 使用时，目录结构应保持如下：

sou-research/
├── SKILL.md
├── README.md
├── LICENSE
├── agents/
├── assets/
├── references/
└── scripts/

在 Codex 项目级技能目录中使用：

Copy-Item -Recurse -Force .\sou-research .\.codex\skills\sou-research

在用户级技能目录中使用：

Copy-Item -Recurse -Force .\sou-research $env:USERPROFILE\.codex\skills\sou-research

安装后可用以下方式触发：

$sou-research 研究中国 AI 行业现状、头部玩家、机会挑战和海外对比

或：

use Sou-Research 分析某个市场机会，并输出 HTML 报告

正式产物流程

推荐流程：

1. 用 Markdown 起草报告。
2. 创建 report_spec.json。
3. 高风险或证据密集报告创建 claims.json。
4. 校验报告规格。
5. 校验 claims 证据账本。
6. 渲染 HTML 或 PDF。
7. 可行时目检渲染产物。
8. 修复溢出、缺失引用、难读表格和弱分页。
9. 只交付真实存在并已检查的文件。

渲染 HTML：

python .codex/skills/sou-research/scripts/render_pdf.py report.md --spec report_spec.json --out report.html

渲染 PDF：

python .codex/skills/sou-research/scripts/render_pdf.py report.md --spec report_spec.json --out report.html --pdf report.pdf

证据标准

Sou-Research 使用来源等级：

• 等级0：审计文件、监管数据库、官方统计、标准、一手数据集
• 等级1：公司/机构官网、投资者材料、产品文档、更新日志、API文档、维护者文档、官方博客
• 等级2：可靠新闻、分析师笔记、行业出版物、学术论文、成熟数据提供商
• 等级3：社区、论坛、Reddit、X、GitHub讨论、应用评论、播客、视频转录、专家访谈
• 等级4：AI摘要、SEO清单文、无来源博客、转载、来源不清页面

重要事实优先使用等级0或等级1。社区信号只能作为情绪或早期信号，不能直接当事实。

文件结构

sou-research/
├── SKILL.md
├── README.md
├── LICENSE
├── agents/
│   └── openai.yaml
├── assets/
│   └── report-templates/
├── references/
│   ├── compliance.md
│   ├── examples.md
│   ├── framework-routing.md
│   ├── investment-research-structure.md
│   ├── pdf-pipeline.md
│   ├── report-contract.md
│   ├── report-styles.md
│   ├── research-depths.md
│   ├── source-quality.md
│   ├── task-brief.md
│   ├── tool-availability.md
│   └── tool-routing.md
└── scripts/
    ├── render_pdf.py
    ├── validate_claims.py
    └── validate_report_spec.py

开源许可

本项目使用 MIT License。你可以自由使用、修改、分发和集成，但需要保留许可证声明。

维护原则

• 默认保持 brief-first，不要把直接执行变成默认。
• 第一轮简报要预填，不要变成空白问卷。
• 深度和内容模式必须分开。
• deep 表示证据和分析更深，不表示更多套话。
• 当用户要核心内容时，优先使用 core-content。
• 具名金融或咨询风格要映射为无品牌预设。
• 来源数量只是启发，来源质量和交叉核查更重要。