qiao-925 通用宏观理解研究
这个 skill-unit 处理的是“如何快速建立某个技术对象的宏观认知”问题。默认输出不是资料堆砌，而是围绕“结构视角 + 演化视角”组织的高可信理解。
Instructions
Step 1：先判断任务是否适合本 skill
优先用于以下对象：
- 技术系统、工程平台、框架、基础设施产品
- 开源项目、技术栈、工具链、架构体系
- 某个工程主题、技术方向或复杂产品能力
不优先用于以下对象：
- 纯产品宣传或市场分析
- 单纯做功能对比、价格比较而不需要宏观理解
- 非技术型人物/公司介绍
如果目标更像“比较、选型、ROI 判断”，优先联动其他 skill，而不是让本 skill 主导。
Step 2：确定执行模式 —— 首轮生成 or 二轮优化
先判断当前任务属于哪种模式：
- 模式 A：首轮生成 适用于目标文档不存在，或现有内容不足以支撑核心认知
- 模式 B：二轮优化 适用于已经有初稿、笔记或旧文档，需要增补、删改、重组和提高认知质量
无论哪种模式，都不要为了制造改动量而机械重写全部内容。
Step 3：固定一级产物 —— 只保留两个主视角
默认只保留两个一级主文档或两大节：
- 结构视角
- 演化视角
可嵌入但不默认升格为平级主文档的视角：
- 运行视角
- 问题视角
- 评估视角
- 工程视角
主线要求：
- 结构视角回答“它由什么构成、主流程如何运转、哪些部件最关键”
- 演化视角回答“它为什么演化成今天这样、哪些转折最重要、未来可能往哪走”
在组织主线、开篇导引、速查信息和洞察提炼时，默认联动 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：统一输出契约 —— 每份文档都要有主线
每份主文档或主章节都应包含：
- 目录
- 资料来源
- 开篇结论
- 正文章节
- 关键洞察 / 总结判断
正文要求：
- 不只回答“是什么”，还要回答“为什么重要”
- 相邻章节有自然过渡
- 相同事实不在不同章节重复堆叠
- 洞察必须来自证据整理与抽象，不能凭空拔高
Step 7：时间与完整性优先级
默认采用有边界的快速研究节奏，通常应在一轮集中工作内完成首版。
若时间不足，优先保住：
- 两个一级视角结构正确
- 关键结论有证据支撑
- 叙事主线完整
不要为了显得全面而牺牲可理解性。
Step 8：根据交付形态选择输出方式
若用户给了目录、文件路径或已有文档，默认更新两份对应文档。
若用户没有给文件路径，则先输出为两大节或两份草稿，再视情况落盘。
Examples
示例 1：首次理解一个复杂技术系统
请帮我做 X 的 general understanding，重点给我结构视角和演化视角。
默认动作：
- 进入模式 A
- 先收集高可信资料
- 再组织为两份主视角文档或两大节
示例 2：基于已有文档继续优化
这两份初稿已经有了，帮我继续优化它们的主线和来源质量。
默认动作：
- 进入模式 B
- 先审阅现有内容
- 保留正确内容，重点修复来源、主线、重复与推断失真
Edge Cases
资料很少或对象很新
若高可信来源不足，必须降低结论力度，并把开放问题显式写出来。
对象太小
如果目标只是一个很小的脚本、简单库或单点工具，可保留“结构视角 + 演化视角”框架，但压缩章节，不要硬凑大文档。
目标更像比较任务
如果用户核心问题是“选哪个更好”，本 skill 只负责补宏观理解背景，不应替代比较型或决策型 skill。
参考资料
knowledge-synthesis- 上游内容综合方法：历史优先、设计意图、阅读路线、速查层与价值聚焦references/execution-modes.md- 首轮生成 / 二轮优化与主控-多 worker 组织方式references/document-contract.md- 两份主文档的统一输出契约与质量标准references/analysis-lenses.md- 结构视角、演化视角及附属视角的边界