用途:将当前对话和代码库理解综合为 PRD 并发布,不访谈用户,直接基于已知信息工作。该 PRD 是“自主性契约”,是人在场时写下的最后产物,需捕获下游自主阶段本会追问的所有决策。
主要能力:探索仓库理解现状;使用项目领域词汇(CONCEPTS.md)并遵循 docs/adr/ 中的 ADR,缺失时从代码综合并记录缺口;按测试透镜规则在尽可能高的接缝处测试可观察外部行为,优先复用已有接缝,接缝越少越好;与用户确认接缝;确定安全门威胁模型精简版,记录到 Security Decisions 部分,预标记安全敏感面;按模板撰写 PRD 并发布到 issue tracker,打上 ready-for-agent 标签;无 tracker 时写到仓库根目录文件并告知用户。
PRD 模板包含:问题陈述、解决方案、用户故事(长编号列表)、实现决策(模块、接口、架构、schema、API 契约等,不含文件路径和代码片段,原型片段例外)、安全决策、测试决策、范围外、进一步说明。
可选面板模式:用户要求多模型 PRD 或领域/接口/后端契约重要时启用,替换 PRD 起草为多席位面板,按 repo_read → product_definition → domain_definition → interface_definition → backend_definition → risk_review → convergence 七阶段运行,使用 python3 shared/scripts/panel_round.py 命令,产物写入 .codex_workflow/spec,并用 python3 shared/scripts/validate_artifacts.py 校验。
限制:不访谈用户获取新需求,唯一例外是未回答的安全门行;不跳过安全决策;PRD 中不放文件路径或代码片段;面板模式止于任务分解前,不产出实现补丁;质量要求是另一智能体无需追问即可制定任务计划。