用途：当用户明确要求 project-scan、扫描项目、生成项目级 AGENTS.md、生成或刷新 README.md，或刷新项目级 Codex 上下文时使用。不用于 feature 开发或 bug 修复，也不允许未经确认覆盖已有 AGENTS.md、README.md、Dockerfile 或脚本。
主要能力：先扫描仓库关键信号文件与目录，输出扫描摘要（技术栈识别表 + 文件存在情况表），并区分"明确识别"与"基于结构的推断"。随后按固定清单补齐脚手架：AGENTS.md、README.md、restart.sh、.claudeignore、.geminiignore、.gitignore、.dockerignore、Dockerfile、docker-compose.yml；清单不可缩减。默认确保项目级 .codex/tasks/、.codex/tasks/archived/、.codex/templates/ 存在。
使用方式：扫描后追问 3-5 个关键问题，包括项目一句话描述、是否生成全套脚手架、已存在文件处理策略（覆盖/增量/跳过）、Docker 暴露端口、API 契约确认。AGENTS.md/README.md 不存在则按模板生成；含 <!-- AUTO:* --> 区块则增量更新自动区块并保留手写内容；无自动区块时由用户选择首次全量重建、追加自动区块或跳过。脚手架文件不存在则按技术栈渲染模板落盘，已存在则询问覆盖或跳过。.geminiignore 内容须与 .claudeignore 一致；restart.sh 落盘后须 chmod +x。
限制：若无法可靠确认启动方式、端口、部署方式或许可证，README.md 须标注"待确认"，不得编造命令；接口契约无法确定时在 AGENTS.md 标注"待用户确认"。若仓库无 Cargo.toml、go.mod、pom.xml、package.json 之一可推断技术栈，须先与用户确认目标技术栈再选模板。项目根目录写入触发权限边界时先走平台审批，不静默跳过。完成后输出已生成、已跳过文件及 .codex 骨架补齐情况与待补充事实。