agentleFS
Sunnyshinnny776Sunnyshinnny776/pm-agentic-cookbook/skills/acceptance-criteria/SKILL.md

acceptance-criteria

Skill4 starsChanged 35 days agoApache-2.0View on GitHub

根据已确认的 Domain Model 和需求依据,生成或修订先于 PRD 的业务验收标准清单,逐条交用户确认。当用户要求定义什么算完成、写验收标准清单、把模型转成验收口径、处理下游缺漏回流时触发。执行测试归 test-authoring;验收标准与 PRD/测试是否一致归 consistency-audit。

18 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

acceptance-criteria

将已确认的业务模型转成用户可逐条核对的完成标准。位置在 Domain Model 之后、PRD Draft 之前;用户确认标准后,下游引用并细化。

输入与边界

调用方给出已最终确认的需求范围说明(名称、业务结果、包含/排除、依赖及验收出口)、需求确认书或源材料索引、所有关联已确认 Domain Model 的文件与版本、清单输出路径及对应台账落点;修订时另给既有清单与关联PRD;基于下游反馈修订时须给具体缺口、期望与观察证据。仅说“缺了一条”时先询问,不能猜是哪条并修改清单;按模型全面补齐清单的请求不依赖下游反馈。按索引锚点取得依据,不自行遍历材料目录。范围仍为候选、缺落点或模型未确认时,停下说明缺项,不能由现有实现反推验收口径。用户已一并确认最终范围和模型时复用该明确确认,不重复询问。

每个已确认、可独立交付验收的需求范围维护一份逻辑清单及一份台账;文件或模块数量不决定范围数量。范围可关联多份模型/PRD,共享模型保持唯一来源。跨模块范围采用已确认主归集位置与协调责任方,其他模块只索引;集成验收范围仅定义共同条件与交互结果,引用子范围版本/共享契约,不复制其标准。这里生成业务标准,交付证据与用户验收由流程执行者维护台账,不在本skill执行实现验收。

Definition负责范围、覆盖推导、格式、确认与回流边界。Consumer显式提供输入和目标路径,不猜业务领域或默认落点。这里只用通用规则,无需领域Provider;如调用方提供领域补充依据,仍须具名说明来源,不能从上下文猜领域。

清单回答业务上什么算完成。页面字段、控件、布局由PRD/UI细化;旅程与测试数据由journey-audit阶段A和test-authoring产出。核对清单与PRD、覆盖清单、测试是否一致归consistency-audit,本skill不自审为独立认证。

生成与修订

  1. 读取范围和依据,定位合法状态转换、关键非法转换、约束/计算边界、角色授权与越权、数据范围及端到端业务流程。先检查依据是否冲突或缺失。
  2. 按 验收标准模板 生成主表,每行只核一件事。模板取不到时按本文五列及三段正文自行组织,在交付说明中注明未套用模板。
  3. 覆盖每条合法转换和关键非法转换;约束与计算覆盖临界值、空值、超限;每个角色与关键操作覆盖授权、越权,涉及数据范围时加范围条目;新建/提交覆盖重复、并发、上游缺失。依据未给预期时列待确认问题,不能发明处理策略或数字。每条端到端业务流程至少有一个可判定的起点到终点条目,另拆出独立结果。
  4. 使用业务语言描述谁、什么条件下、做什么及可观察结果;一行多个结果须拆开。避免字段名、接口、控件和“正确处理”“友好提示”。只在来源明确规定性能、安全等要求时增设非功能节,不凑常见指标。
  5. 交付前重新读取已写出的主表,逐行核对单一可观察结果;“待确认”行同样只问一个结果或一个参数,不能因为尚未裁定就把两个问题捆在一格。判断能否出现“前半项满足、后半项不满足”:能就拆成两行,沿最大编号续增。状态落点、独立副作用、记录数量、返回对象分别可观察,应各占一行。例如预约状态已确认与提醒送达是两项结果,必须分行;这个检查不输出额外自审表。核对每行来源与判据,将推断、缺值和冲突列入待确认清单;全部新行状态为待确认。提出需要用户逐条确认的事项后停下,不继续写PRD,也不代用户确认。
  6. 用户明确确认某些条目时,只更新这些条目;未获确认的保持待确认。仅确认编号或“这个问题需要处理”,却未给必要业务答案时,该行仍待确认,不能把未定义预期当已确认标准。答案影响模型时先更新并确认模型,再修订标准定义。确认完成后交付清单名称、版本和路径供下游引用;不替下游执行者生成旅程、测试数据或测试代码。

文档契约

文档标题可带清单版本标识;没有版本的既有清单保留真实快照定位,不捏造已发布版本。文首只保留三行:范围、依据(文档名及版本)、状态(草稿/已确认)。正文只有主表、待确认清单与变更记录;可有文档标题。主表按关键业务场景、异常、权限、边界条件分节,非功能仅在有明确来源时增加。每节固定五列:

编号场景预期结果来源状态
  • 每行独立可判定,不将多个业务结果合在一行。
  • 来源写“文档名称 第N节『节名』”,可附链接;文档内部定义的业务编号可括注,绝不能仅写编号。执行计划、审计报告、问题登记表的编号不进入清单。没有直接来源时写明推断及依据位置,列入待确认清单;不能伪造锚点。
  • 行状态只用待确认、已确认、作废。编号采用AC-n,延续既有清单的最大编号,只增不复用;作废行保留并划掉内容,编号不回收。修订不重排老编号。
  • 同一范围连续修订沿用清单及台账,保留当前定义与简要变更记录,不逐轮追加旧全文。只有新可独立交付范围才新增一组。范围拆分/合并经用户确认后保留旧范围、清单及条目到新归属的映射,旧编号不复用、不静默消失;不能按子功能自行拆出多份权威清单。
  • 推断和具体值未知时,在预期结果中明确待确认问题,不把建议值包装为事实。
  • 待确认清单写明涉及的条目、问题及要用户决定什么;无问题写“无”。变更记录写日期、编号、变更、回流来源阶段、确认人;未确认不填实际确认人。
  • 文首“已确认”仅在范围内所有未作废行获明确确认且待确认清单已清空时使用。部分确认仍为草稿;不能从文件已有“已确认”字样推断本次新增/修改条目也获确认。

下游回流

任一下游阶段发现上游依据漏了、错了或做不到时,暂停受影响工作,定位原依据和所有引用载体,不在下游自行改口径。先回改最上游有问题的产物;涉及模型时先修模型并获确认,再修改清单。

获任务授权时在清单新增或修改条目,将受影响的已确认行改为待确认,变更记录注明来源阶段。没有修改授权或依据无法判定时,只交回具体缺口,不能覆盖来源。等待用户确认后,逐项检查并同步引用该行的PRD、覆盖清单和测试;不能把旧测试绿色结果沿用为新标准的验证。

下游引用使用“清单名称 AC-n”,可附路径/锚点,不写裸AC编号、不复制主表作为第二份权威规则。

范围变化先交用户确认,并列出受影响的模型、清单、PRD、覆盖/测试及台账;不能因实现不全自行缩范围。标准确认只表示用户认可定义,保持待确认/已确认/作废三档;交付验收不会把标准改为“已满足”或删除已通过标准。修订后交接具名编号、新版本和影响范围,供台账重新核对。

停机条件

  • 范围内的覆盖推导已逐项核对;来源真实可定位;每行可判或明确待确认。
  • 主表五列、三档状态、编号延续正确,待确认清单与变更记录齐全;未编造依据、数字或用户确认。
  • 草稿生成结束即停下交用户确认,不能宣告验收通过或自动推进PRD。修订后的推进仍以逐条确认为前提。
  • 最终范围或模型未确认、来源不可读或冲突、清单/台账落点未给出时停下说明缺项;同一业务缺口两次追问仍无法定位依据时保留草稿与未决清单,不猜答案。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.