datawhalechina Inspect Codebase
Overview
这个 skill 用来帮助执行层先建立项目上下文，再进入更具体的读取、修改或总结任务。
Workflow
- 先查看顶层目录，再判断项目的大致边界和主要模块。
- 每个侦察任务里，目录树脚本或顶层 listing 最多做 1 次；拿到边界后就转向
glob/grep/read，不要反复列目录。 - 优先用
glob和grep缩小范围，不要一开始就大面积read。 - 只有在确定目标文件后，才读取最小必要片段；通常 1 个入口文件 + 2 到 5 个关键实现文件就足够支撑模块说明。
- 如果
done_when已经能被当前证据覆盖，就直接整理结论；不要为了“更完整”继续漫游式读取。 - 结论必须基于已经读到或搜到的证据，不要把猜测当事实。
- 如果用户后续还要修改代码，把关键入口、配置文件和依赖关系记录清楚。
Resource Guide
- 需要快速列出有限深度目录树时，可运行
skills/library/inspect-codebase/scripts/print_tree.py。 - 推荐命令形式：
python skills/library/inspect-codebase/scripts/print_tree.py . --depth 2，也兼容旧写法python skills/library/inspect-codebase/scripts/print_tree.py . 2。 - 需要更细的排查顺序时，按需读取
skills/library/inspect-codebase/references/inspection-patterns.md。
Output Expectations
- 输出目录结构时，优先保留和当前任务相关的部分。
- 输出实现位置时，尽量给出文件路径、关键函数或类名。
- 如果没有直接读到某个 dataclass 字段、函数签名或返回值，就不要把它写进结论。
- 对分析类任务，允许输出“基于当前已读文件可确认的结论 + 尚未展开的部分”，这比编造完整细节更好。
- 如果仍然缺少证据，要明确指出“还没读到哪些文件”。