用途:扫描项目源码,产出面向 QA 的清单,包括编程语言、应用框架、测试框架以及现有的自动化测试与手动测试(.test.md)。适用于测试规划前了解代码库、识别所用框架、查找已有测试。
主要能力:遍历项目目录收集源码文件路径(不读取内容);按扩展名、结构和配置文件推断语言与框架,输出统一 frameworks 数组;从配置文件或根目录名提取项目名;按源码文件数量评估复杂度(1-30 小、31-150 中、151-500 大、500+ 超大)。测试盘点较浅:通过配置文件、依赖和常见命名模式识别自动化测试框架并统计文件;用 find 命令解析 .test.md 中的 suite 与 test 标题。
使用方式:扫描根目录时若未发现源码,会询问源码位置(另一文件夹、Git 仓库或暂不处理),并可将外部数据拉取到 .testclaw-context/ 下(需将其加入 .gitignore,仅添加一次)。输出为结构化 Markdown,不写文件;测试列表最多显示前 20 条并标注截断。
限制:不做深度解析,不解析完整导入、不逐行读取、不推断复杂代码关系;排除依赖、构建产物、缓存、配置、锁文件与环境文件以及 TestClaw 内部文件;不猜测缺失数据,不添加未定义字段。若无法创建上下文目录、访问源码路径或无读权限则硬失败。