用途:将通用脚手架转化为项目专属的操作系统,通过捕获意图、权衡与约束来定制文档,并创建或完善仓库的规范执行契约 REPO_PROFILE.json(位于仓库根目录)。全局配置 ~/.codex/repo_profile.json 仅作参考模板。
主要能力:扫描仓库结构与现有文档(AGENTS.md、ARCHITECTURE.md、CALIBRATION.md、ROADMAP.md、DECISIONS.md)及已有 REPO_PROFILE.json;通过 5–8 个开放式问题了解项目目标、昂贵错误、严格与灵活项、可临时混乱的部分、失败模式、协作风格、范围外事项与约定;据此提出对上述文档及 .codex/SKILLS.md 的具体修改建议;创建或更新 REPO_PROFILE.json,包含 stack、commands(lint/typecheck/test/build)、paths、quality_bar.required_checks、conventions.package_manager 等最小必填字段;最后输出 8–14 行完成报告。
使用方式:先只读扫描上下文,再提问;在收到回答或用户同意按已声明假设继续前不得编辑文件。修改现有文件而非创建重复文件,保持最小差异。若命令未知,记为 "unknown" 并列为待解决问题;绝不存储密钥。
适用场景:需要把脚手架落地为具体项目规范、统一文档与执行契约时。
限制:不做深度代码分析;不引入新技能除非明确要求;不打印完整文件内容;若文档已高度定制,仅做最小增量修改。