用途:在意图定义之前,对已有项目建立事实基线。先检测、扫描、审计,证据落盘后才提出建议或问题;不对流水线尚未读取的代码库向用户提问。
主要能力:判断项目属于 owned、orphan、greenfield 还是 brownfield;生成并冻结文档清单;并行派出 codebase mapper(角色 codebase-mapper,输出 .project/research/evidence-codebase.md)与 docs auditor(角色 docs-auditor,输出 .project/research/DOCS-AUDIT.md),汇总项目栈、架构、入口点、成熟度、经验证可用的部分,以及文档与代码之间的漂移和无文档内容。
使用方式:若 STATE.md 缺失,先运行 python3 <absolute-bundled-script> initialize --repo <absolute-root> --template <absolute-state-template> --require-git(脚本 scripts/detect_project.py),按其返回的 JSON 裁决与路由处理,再继续。初始勘察可用 python3 <absolute workflow_run.py> prepare-inspect --repo <absolute root> --expected-head <recorded HEAD>,完成后用 finish-inspect。文档审计校验使用 python3 <absolute check_docs_audit.py> --repo <docs sidecar> --primary <absolute primary> --audit <track-relative DOCS-AUDIT.md> --inventory <frozen inventory file>。阶段结束用 python3 <absolute pipeline_state.py> transition 将状态置为 inspect/done。
限制:扫描为只读,仅可改动 .project/ 之外无内容;项目命令只在按记录干净修订创建的临时校验工作树中运行,绝不在源工作树执行;文档与代码冲突只呈现不自动裁决;同一里程碑不得重复进入 inspect/done。绿色项目跳过勘察直接进入定义阶段。具体收费、价格与平台信息暂未提供。