需求到验收

将已确认的软件需求拆分为小型 PR,协调并行 worktree 开发,实现者运行自证测试,执行代码与安全审查,最多三轮收敛,组合验证与人工验收。适用于开发任务,不会为普通讨论自动触发实现。

O que é 需求到验收?

该技能(需求到验收)是一个为 AI 代理(如 Claude Code、Cursor 等)设计的结构化开发工作流,用于将已确认的软件需求分解为小型的、可独立测试的 PR,并协调并行开发。它适用于复杂的开发任务,但不会为一般性讨论自动启动实现。 其核心价值在于确保每个功能边界清晰、有独立的 worktree 和分支,并通过严格的审查和验证流程降低风险。具体工作流包括:复述需求并获得确认、协调者直接拆分功能、实现者运行测试并附上实际证据(如截图、API 结果)、进行代码与安全审查、最多三轮收敛解决问题、组合版本检查以及最终的人工验收。它还包含模型选择策略和项目规则集成指导,以控制成本并保证流程的一致性。 该技能在多种平台(如 Claude Code、Cursor、Codex)上都能工作,因为它不依赖于特定平台的 API,而是通过遵循 SKILL.md 中定义的规则来指导 AI 代理的行为。用户需要在项目级的 `AGENTS.md` 文件中引用该技能和相关的审查规则,以确保流程正确激活。

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuShenLiu06/yushen-skills/tree/HEAD/skills/yushen-pr-cycle

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 示例,仅保留实际适用、可验证的条款。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas