chartlisted

# Software Study 把"软件"当成有版本、有源码、有运行时的可操作对象来学，而不是把官网页面归档一遍。 核心产物是一个持续更新的 Study Hub，连接：官方来源地图、版本边界、架构模型、源码证据、实践证据和掌握矩阵。 ## 与 acquisition 的边界 若由 `acquisition` 判断为“软件/仓库/开发工具/平台/产品 + 系统学习”并自动交接，`chart` 是后续独立入口。接收 packet（`subject`、`intent`、`source_url/path`、`origin`、`clipping archive path if created`、`raw/query status`）后，必须先独立执行自己的 source identity，再按本页流程建立 Study Hub；不恢复或继承 Acquisition owner/state，也不把 handoff 当作 `calls`。仍可按 Step 2 独立复用 Acquisition 的脚本。 | 对象 | 使用 | 产物 | |---|---|---| | 文章、论文、课程、知识库、资料合集 | `acquisition` | raw + query + collection Hub | | 软件、仓库、开发工具、平台、产品 | `chart` | Study Hub + 来源/版本清单 + 架构模型 + 源码证据 + 实践证据 | 判断依据不是"输入是不是很多网页"，而是学习目标：网页是内容主体，还是软件的其中一层证据。 ## 六类状态 1. **学习目标** — 使用 / 理解架构 / 二次开发 / 性能调优 / 长期维护。目标决定深度和要读的源码。 2. **官方来源地图** — 官网文档、repository、examples、API reference、architecture docs、release notes、issues。第三方材料只用于解释和发现线索，不作为规范性结论。 3. **版本边界** — 本机版本、官方文档时间点、源码 commit/branch。版本变化时更新清单，不把当前结论无条件外推。 4. **Study Hub** — 整体架构、资料规模、阅读顺序、各模块状态、子 query 链接、未解问题。 5. **证据等级** — 官方文档=产品主张；源码=实际实现；示例/测试=预期行为；本机实验=当前环境可复现证据。四类分开记账。 6. **掌握 Gate** — 能画出系统结构、能解释核心数据流、能定位关键代码、能运行最小示例、能修改一个行为并验证、能说明适用边界和主要失败模式。 ## 工作流 ### 1. 钉住版本与范围 先确认本机版本、官方仓库 commit、文档时间点，写进来源清单。范围不明时先问清学习目标。 ### 2. 盘点官方来源 优先官方 sitemap、docs、repository、examples。用 `acquisition` 的脚本做来源身份检查和 raw 归档，不复制一套抓取实现： ```bash python ~/.agents/skills/acquisition/scripts/source_identity.py --wiki-root <wiki-root> --url "<url>" python ~/.agents/skills/acquisition/scripts/extract_article.py "<url>" --save-raw --w