用途:在进入不熟悉的项目时使用,帮助快速建立对仓库的工作模型。除非用户明确要求修改,整个过程保持只读。
主要能力:梳理项目目的与领域、技术栈与包/构建工具、仓库结构、重要入口与配置文件、构建/测试/lint/运行/部署命令、已有文档与项目说明,以及潜在风险区域和后续问题。
使用方式:先读项目说明,检查 AGENTS.md、.codex/、.agents/、README 及核心 docs,越靠近项目的说明越具体。用 rg --files 和浅层目录列表映射结构,避免输出巨大目录树或读取生成/依赖目录。检测技术栈时查看 package.json、pnpm-lock.yaml、yarn.lock、pyproject.toml、requirements.txt、Cargo.toml、go.mod、platformio.ini、CMakeLists.txt、compose.yaml、CI 工作流和框架配置文件。从包/配置文件中提取脚本与命令,优先使用有文档记录的命令,标注可能但未验证的命令。只读理解架构所需的代表性文件,识别入口、路由、服务、硬件目标或 CLI 命令。总结时保持简短可执行,区分已确认事实与推断,指出影响后续工作的未知项。
输出结构:项目目的、技术栈与工具、重要文件/目录、运行/测试/构建命令、架构说明、已有文档/说明、风险或注意事项、建议下一步。若用户要求更深入的 onboarding 文档,先提出目标文件并等待明确批准后再创建。
限制:默认只读,不修改文件;不编造命令或功能;未验证的命令需标注;避免读取生成或依赖目录。