O que 需求到验收 faz?
1. 复述并确认
复述用户目标、非目标、可观察验收条件、风险与预算约束。确认后进入实现;已有明确确认可以沿用,不重复索取授权。只补问真正影响实现的缺口。此流程不扩大工具、费用、推送、合并或部署权限。
2. 协调者直接拆分
- 协调者直接给出功能边界、依赖、接口、负责人和验收项,不再增加一层拆分代理。独立任务并行,依赖任务按接口和顺序推进。
- 一个可独立测试、回滚的功能对应一个独立 worktree、分支和真实 PR。固定目标分支及 base/head SHA;不同实现者不共写工作目录,不借用其他任务的分支。
- 单功能 PR 的最终 additions + deletions 尽量不超过 1000 行,含测试、文档及生成文件。超出先合理拆分;无法拆分则说明原因和规模,不能隐藏生成文件或硬拆半个功能。
- 多功能批次记录子 PR URL、依赖和独立验收项。可按项目已支持的堆叠 PR 或集成分支组织,核实实际能力;文档中的任务编号不能冒充真实 PR。
3. 实现者实际运行并自证
- 实现者完成实现、自检和关键用户路径运行后再交独立审查,不把主要运行验证和截图工作转交审查者。
- 记录精确 SHA、命令、环境、实际结果、未测项与风险。Bug 提供修复前复现及同路径修复后结果。构建、mock、真实服务验收分开报告。
- UI 变更给出关键步骤和结果的实际运行截图。截图放 PR 评论或附件,不提交代码分支。先核实上传工具支持的参数;上传受阻就报告阻塞,不编造附件 URL。
- 后端权限、数据或资金行为给出相应 API / 数据证据。测试使用隔离环境与合成数据,不泄漏凭据和个人数据。
- 无 UI 的规则或文档变更不伪造截图;检查范围、链接、规则一致性与 diff 即可。容器验证使用获授权的隔离环境,不擅自回退用户个人机器。
- PR 使用 四节模板,每项证据关联实际提交。
4. 代码与安全分别审查
- 优先复用仓库已配置的自动代码及安全审查,分别核实完成状态、覆盖 SHA 和未结发现。不额外派重复审查,也不重复手动触发。
- 未配置、未触发或未覆盖目标 SHA 时报告缺口;按已授权的备用方案处理,无备用授权时取得决策。没有评论不等于审查完成。
- 代码质量按需读取已安装的
yushen-code-quality-review;安全按需读取yushen-security-review。路径以实际安装位置为准,缺失或未读取就说明。 - 审查只提出有证据的问题;外部实现可以比较和建议,未经用户采纳不改方案、迁移或加依赖。
5. 最多三轮收敛
一轮为审查反馈 → 修复或有证据的处置 → 验证。代码和安全汇总计轮,合计最多三轮;换代理、模型、重试、restack 或重开同一工作 PR 不重置。
首轮结合需求审完整 diff;第二、三轮检查新增 diff、已有问题闭环和受影响回归。以稳定问题 ID 合并同根因发现,记录位置、证据、首次轮次、状态、修复 SHA 与验证。误报用证据说明,不能为了消除评论做无意义修改。未经复核不标已解决。
同一问题两轮有效修复仍无进展可以提前升级。第三轮仍有未解问题时停止自动收敛,交协调者汇总证据、重新考虑方案并请求决策;不得降门槛、自动通过或合并。
6. 组合版本检查
协调者核实最终必要 CI、冲突解决、共享状态和组合用户路径,记录每个子 PR SHA 与组合候选 SHA。各层通过不代表组合通过。rebase、冲突处理或实现变化后更新 SHA 映射,补受影响回归;旧证据不能冒充当前版本结果。
7. 人类验收
提供候选 SHA、可运行产物、最短测试步骤、预期结果和剩余风险。用户本人测试并明确确认对应版本后,才按实际授权合入。代码改变后重新确认受影响部分;自动测试和机器人批准不替代本人验收。发布、部署按各自授权处理。
交付安装器、桌面应用或其他实际发布产物时,按需读取已安装的 yushen-release-acceptance,验证最终下载文件到可用的完整路径,并区分平台结论与预览限制。纯文案或内部小改动不强制执行整套发布验收。
模型和成本策略
按可配置的任务难度、风险、预算与可用能力选择模型:确定性检查优先脚本;明确局部实现优先低成本档;复杂诊断、设计和高风险判断选择能力适配档;证据整理使用较低成本档。开始时说明所选角色、成本边界与升级条件,不把特定型号视为公开环境默认可用。
先排除环境故障与缺上下文,再决定是否升级。超过预算、增加付费调用或越出授权能力时先取得对应决策;不无限重试。批次结束按需使用 返工总结,规则更新走正常验收流程。
项目规则接入
在项目 AGENTS.md 中明确要求按任务读取相关技能和 REVIEW.md;不假定链接自动展开。REVIEW.md 只放可判断的长期项目规则,逐轮发现与证据留在 PR。缺文件或约束冲突应报告,不臆造机制。
创建项目规则时可按需参考 通用 REVIEW 示例,仅保留实际适用、可验证的条款。