# General Understanding Research

> 通用宏观理解研究能力单元，帮助 Agent 在首次理解某个技术系统、框架、平台、产品工程、开源项目或工程主题时，以结构视角和演化视角构建高可信的总体认知，并支持对已有理解文档做二轮优化。关键词：general understanding、信息收集、技术调研、结构视角、演化视角、宏观理解、多 agent、文档优化。

- Skill: `qiao-925/general-understanding-research` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add qiao-925/general-understanding-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qiao-925/general-understanding-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: qiao-925 (https://skillmd.com/u/qiao-925)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qiao-925/general-understanding-research

---


# 通用宏观理解研究

> 这个 skill-unit 处理的是“如何快速建立某个技术对象的宏观认知”问题。默认输出不是资料堆砌，而是围绕“结构视角 + 演化视角”组织的高可信理解。

## Instructions

### Step 1：先判断任务是否适合本 skill

优先用于以下对象：

- 技术系统、工程平台、框架、基础设施产品
- 开源项目、技术栈、工具链、架构体系
- 某个工程主题、技术方向或复杂产品能力

不优先用于以下对象：

- 纯产品宣传或市场分析
- 单纯做功能对比、价格比较而不需要宏观理解
- 非技术型人物/公司介绍

如果目标更像“比较、选型、ROI 判断”，优先联动其他 skill，而不是让本 skill 主导。

### Step 2：确定执行模式 —— 首轮生成 or 二轮优化

先判断当前任务属于哪种模式：

- 模式 A：首轮生成
  适用于目标文档不存在，或现有内容不足以支撑核心认知
- 模式 B：二轮优化
  适用于已经有初稿、笔记或旧文档，需要增补、删改、重组和提高认知质量

无论哪种模式，都不要为了制造改动量而机械重写全部内容。

### Step 3：固定一级产物 —— 只保留两个主视角

默认只保留两个一级主文档或两大节：

1. 结构视角
2. 演化视角

可嵌入但不默认升格为平级主文档的视角：

- 运行视角
- 问题视角
- 评估视角
- 工程视角

主线要求：

- 结构视角回答“它由什么构成、主流程如何运转、哪些部件最关键”
- 演化视角回答“它为什么演化成今天这样、哪些转折最重要、未来可能往哪走”

在组织主线、开篇导引、速查信息和洞察提炼时，默认联动 `knowledge-synthesis`：

- 对存在演化脉络的对象，优先讲清前因后果
- 解释设计目标、约束与取舍，而不是只列现状
- 开篇先给出阅读路线与重点结论
- 需要时提供速查层，但不让其抢走正文主线

### Step 4：采用主控收敛式多 Agent 组织

若环境支持 multi-agent，默认组织方式为：

- 1 个主控 Agent
- 1 个结构视角 owner
- 1 个演化视角 owner
- 可选 0-2 个资料采集 worker

执行约束：

- 一个一级文档只能有一个 owner
- worker 可以提交证据包、章节草稿、修订建议
- 最终术语、顺序、过渡、删重和结论力度必须由主控统一
- 不允许多个 worker 各写一篇完整终稿后直接拼接

若环境不支持多 agent，则单 Agent 也必须显式模拟这套分工：先收证据，再分视角，再统一编排。

### Step 5：来源收集依赖 `source-quality-control`

本 skill 不重复定义来源分级，而是默认联动 `source-quality-control`：

- 关键结论优先由高可信来源支撑
- 事实、推断、开放问题必须分开
- 高时效内容默认重新验证

收集目标不是“来源越多越好”，而是：

- 来源等级清楚
- 关键结论可回溯
- 不同来源能够形成结构化判断

### Step 6：统一输出契约 —— 每份文档都要有主线

每份主文档或主章节都应包含：

1. 目录
2. 资料来源
3. 开篇结论
4. 正文章节
5. 关键洞察 / 总结判断

正文要求：

- 不只回答“是什么”，还要回答“为什么重要”
- 相邻章节有自然过渡
- 相同事实不在不同章节重复堆叠
- 洞察必须来自证据整理与抽象，不能凭空拔高

### Step 7：时间与完整性优先级

默认采用有边界的快速研究节奏，通常应在一轮集中工作内完成首版。

若时间不足，优先保住：

- 两个一级视角结构正确
- 关键结论有证据支撑
- 叙事主线完整

不要为了显得全面而牺牲可理解性。

### Step 8：根据交付形态选择输出方式

若用户给了目录、文件路径或已有文档，默认更新两份对应文档。  
若用户没有给文件路径，则先输出为两大节或两份草稿，再视情况落盘。

## Examples

### 示例 1：首次理解一个复杂技术系统

```text
请帮我做 X 的 general understanding，重点给我结构视角和演化视角。
```

默认动作：

- 进入模式 A
- 先收集高可信资料
- 再组织为两份主视角文档或两大节

### 示例 2：基于已有文档继续优化

```text
这两份初稿已经有了，帮我继续优化它们的主线和来源质量。
```

默认动作：

- 进入模式 B
- 先审阅现有内容
- 保留正确内容，重点修复来源、主线、重复与推断失真

## Edge Cases

### 资料很少或对象很新

若高可信来源不足，必须降低结论力度，并把开放问题显式写出来。

### 对象太小

如果目标只是一个很小的脚本、简单库或单点工具，可保留“结构视角 + 演化视角”框架，但压缩章节，不要硬凑大文档。

### 目标更像比较任务

如果用户核心问题是“选哪个更好”，本 skill 只负责补宏观理解背景，不应替代比较型或决策型 skill。

## 参考资料

- `knowledge-synthesis` - 上游内容综合方法：历史优先、设计意图、阅读路线、速查层与价值聚焦
- `references/execution-modes.md` - 首轮生成 / 二轮优化与主控-多 worker 组织方式
- `references/document-contract.md` - 两份主文档的统一输出契约与质量标准
- `references/analysis-lenses.md` - 结构视角、演化视角及附属视角的边界