用途:快速、可预测地为目标仓库创建或刷新标准脚手架,建立结构纪律而非产品方向,使后续技能更容易理解仓库。
主要能力:生成或更新 AGENTS.md、ARCHITECTURE.md、CALIBRATION.md、DECISIONS.md、SUGGESTIONS.md、REVIEW_QUEUE.md、ROADMAP.md、Tree.txt 和 .codex/SKILLS.md;确保 .codex/telemetry/ 存在;生成排除 .git、.venv、node_modules、.next、dist、build、缓存目录等路径的 Tree.txt。模板取自 ~/.codex/templates/repo-scaffold/,缺失时回退到内置最小模板,严格按模板填写占位符,不自行发明新章节。
使用方式:先对仓库做只读快速扫描,识别根目录、已有脚手架文件、技术栈线索(package.json、pyproject.toml、Makefile、CI 配置等)及可发现的测试/构建命令;随后提出 8–12 个多选设置问题(仓库身份、技术栈形态、近期目标、风险姿态、变更纪律、测试姿态、决策严谨度、路线图格式、边界、技能使用、README 处理),支持直接回复 defaults 全部采用推荐项;答案不完整时按推荐默认继续并记录假设。模板高置信度时可生成最小 REPO_PROFILE.json,低置信度则跳过并转交 $personalize-repo,不覆盖已有 profile。完成后输出 8–14 行简报,列出创建/更新的文件、假设与后续推荐步骤($intake-interview、$personalize-repo 或 $create-plan),不打印完整文件内容。
限制:不得创建重复文件(如 foo_copy.md),已有文件只能就地修改;技术栈推断为启发式而非深度扫描;答案矛盾时采用推荐默认并记录假设;已有文件与模板差异过大时只做最小修改而非整体重写。仅在明确调用时使用。收费、价格与具体平台支持情况暂未提供。