用途:面向想亲自读懂代码的人类(而非让智能体代为分析),提供交互式代码库导览。它复用与 exploring-codebases 相同的 tree-sitting + featuring 流水线,但产出的是通过 composing-html 合成的引导式 HTML 练习,而非分析文档。
主要能力:先做结构扫描与特征收集,再针对练习目标提取真实源码(入口点、函数、导入、配置、测试名),生成含上下文、代码与“你的回合”问题的 HTML 卡片,答案放在 details 中点击才显示。练习类型包括入口点走查、架构综合、依赖侦探、配置阅读、测试即规格。可选生成可独立打开的 orientation.html 导览文档。
使用方式:会话开始时执行 uv venv、uv pip install tree-sitter-language-pack 并设置 PYTHON、TREESIT、GATHER、COMPOSE 环境变量;用 curl 拉取仓库 tarball 或直接指向本地路径;依次运行 treesit --stats、gather.py、treesit 查询提取源码;再用 build.py build freeform 生成 HTML。流程分三阶段:框架介绍(需用户确认)、两个交互练习、综合提问。
适用场景:刚接触某仓库、想建立初步心智模型时;需要持续学习可搭配 learning-opportunities。
限制:不向用户展示原始流水线输出;答案不在聊天中预览;脚手架按熟悉度递减,但综合仍由用户完成;用户卡住时应展示更多代码而非给提示。具体收费、平台支持等信息暂未提供。