用途：将仓库根目录的 project-env.yaml 作为工作站与 Codex 环境要求的唯一事实来源，用于上手引导、环境漂移检查、安装请求和依赖要求变更。
主要能力：读取契约并匹配当前平台（操作系统与 shell）；遍历匹配平台块中的 components[] 进行验证；对 semver 比较运行 verify.command 并用 verify.output_regex 提取版本后比对；对 exists 检查仓库相对路径；对 manual_check 标记为人工核验项；required: true 缺失或不合规视为阻塞。
使用方式：先读仓库根目录 project-env.yaml，需要字段说明时加载 references/schema.md。按平台匹配、组件验证、变更前报告、执行已批准安装、维护契约的流程工作。审计输出包括匹配平台、满足组件、阻塞缺口、可选缺口、人工核验项及待批准后运行的安装命令。执行时只运行匹配平台已批准的安装命令，每批安装后重新验证受影响组件，仍失败则报告失败步骤并停止。团队需求变化时先更新 project-env.yaml 并在同一任务中刷新 updated_at。
限制：不要求创建或更新 AGENTS.md；无精确平台匹配时停止并请用户新增平台块，不得猜测；required 组件缺失且无 install.command 时停止并请用户提供手动安装步骤或更新契约；未获明确确认前不安装或重配置任何内容；已验证或人工步骤失败至少两次后才添加辅助脚本。不提供可靠 CLI 验证路径的插件或 MCP 应标记人工核验。