用途:把代码仓库建成可复用、可证伪的模型,用带 file:line 引用的方式追踪从入口到测试的流程,便于入职、审计与后续研究规划,不修改代码,也不做最终判定。
主要能力:支持 mode(baseline/delta)、view 侧重(心智模型、限定审计、模式证据、综合)、lens(persistence、auth、CLI、build、test,每次只用一个)与 depth(quick/standard/deep);每项事实须引用 file:line,推断须引用其所依据的事实;明确列出已检查与未检查范围;先读取仓库自述(README、架构文档、构建清单、CLI 帮助)再核对代码,避免 grep-first 漂移;存在先前包时优先用 delta 复用已验证证据。
使用方式:技能位于 https://www.skills.sh/boshu2/agentops/codebase-recon。典型调用如 codebase-recon --mode=baseline --view=audit --lens=cli --depth=standard。先运行 skills/codebase-recon/scripts/validate-output.sh --repo-root <target> --discover-priors 查找先前清单;无先前包用 baseline,有则验证后转 delta。产物默认写入 .agents/scratch/codebase-recon/<run-id>/,含 codebase-recon.json 与 codebase-recon.md,并执行 skills/codebase-recon/scripts/validate-output.sh <codebase-recon.json> 校验。重建其他仓库时需传 --repo-root <target>。遗留目录 .agents/recon/<run-id>/ 仍保留,发现先前包会枚举两处默认路径。
适用场景:代码库勘察、仓库审计、onboarding 需要带引用的心智模型,以及按持久化、认证、CLI、构建、测试某一领域深入追踪。
限制:不给完成判定,也不产出代码变更计划;无法引用的主张降级为 unknown;delta 需已有先前的有效清单链、ancestor 提交与 baseline_verified: true;校验要求干净工作区,拒绝 .agents/ 之外的脏状态;证据须为仓库相对的常规文件路径;打包模式请用 pattern-mining,最终 PASS/FAIL 请用 validate。价格、收费与平台等细节暂未提供。