用途：当用户明确要求 project-init、cc-project-init、初始化新仓库、生成项目级 AGENTS.md，或按技术栈补基础脚手架时使用。不用于已成熟项目的大规模重写、代替 feature 开发或 bug 修复、无确认地覆盖已有 AGENTS.md、Dockerfile 或脚本，也不为 Claude/Gemini 生成专属配置文件。默认生成 README.md 这类扫描型项目文档；需要生成或刷新 README 时改用 project-scan。
主要能力：先读取仓库现状，判断是空仓库、样板仓库还是已有部分脚手架；优先从现有文件推断技术栈，再只问缺失的关键信息（项目描述、启动方式、数据库迁移、额外约定、是否需要脚手架文件）。需要项目级说明时，以 assets/AGENTS.project.md 为起点生成仓库根目录 AGENTS.md，聚焦项目特定约定，不重复用户级全局规则；模板中的 AUTO:* 区块可供后续 project-scan 增量刷新。若项目包含 Java 代码，文档和代码署名统一使用 wwj，新增 Java 文件或补齐文件头注释时使用 @author wwj。默认同时初始化项目级 .codex/ 最小骨架：.codex/tasks/、.codex/tasks/archived/、.codex/templates/，保证后续 new-feature 可直接持久化任务；若目录已存在则只补缺失项，不整目录覆盖。若项目根目录没有写权限，必须先触发平台原生审批流程；只有审批后仍失败，才说明当前会话无法在该项目内初始化骨架。只有用户明确要创建或补齐额外脚手架时，才从 assets/ 选择对应模板，不要默认把所有模板都写进仓库。
使用方式：目标文件已存在时，先比较差异并说明保留/合并策略，避免整文件覆盖。若用户预期生成 README.md、技术栈摘要、目录结构或快速开始说明，明确说明这是 project-scan 的职责，并建议继续执行 $project-scan。完成后说明创建了哪些文件、哪些模板没有使用，以及后续建议。资源选择：项目级说明模板 assets/AGENTS.project.md；项目级 .codex 骨架 assets/codex-skeleton/；Go/Docker/compose/重启脚本模板按需从 assets/ 选择；具体规则见 references/template-selection.md。
输出要求：先说明识别到的项目形态和技术栈假设；只为用户确认过的文件落盘；新建文件默认可直接用，但保留最少必要占位符；明确指出哪些内容仍需用户补充或替换。若用户已执行 tools/sync-config.sh，必须明确说明项目级 .codex 骨架仍需在目标项目根目录内由 project-init 或 new-feature 实际落盘，不要把用户级 ~/.codex/project-template/.codex/ 当成已完成的项目初始化。