用途：在架构评审前理解模块边界与文件组织；探索陌生代码库时先摸清结构再改动；作为重构或迁移工作量估算的输入。不适合用于一般性代码探索（应改用 Explore agent）或查找特定模式（应直接用 Grep）。
使用方式按四个步骤进行，并以 TodoWrite 条目记录进度：
- 确认根目录（file-analysis:root-identified）：用 pwd 确认分析根目录，记录 monorepo 边界、工作区根或子项目路径，并从 package.json、Cargo.toml、pyproject.toml 等清单文件判断项目类型（语言、框架）。
- 映射结构（file-analysis:structure-mapped）：运行 tree -L 2 -d 或 find . -type d -maxdepth 2 获取顶层目录布局，识别 src/、lib/、tests/、docs/、scripts/、configs/ 等标准目录，记录可能影响后续分析的非标准组织方式。
- 检测模式（file-analysis:patterns-detected）：按扩展名统计文件数量，识别主要语言及其文件分布，记录配置文件、生成文件和内置依赖；可抽样查看文件大小。
- 标注热点（file-analysis:hotspots-noted）：找出大文件（潜在“上帝对象”），标记嵌套过深的目录，记录命名或位置异常的文件。
退出标准：TodoWrite 各项均以具体观察结果标记完成；下游工作流（架构评审、重构）获得结构上下文；文件数量、目录布局与热点均有记录可供参考。
限制：资料未说明该技能的运行环境、依赖安装方式、平台支持、收费情况或效果指标，暂未提供。