mcpField
A
acceptance-check

acceptance-check

github.com/jayden-dang测试与质量144 次安装4 天前更新
代码仓库

关于 acceptance-check

acceptance-check 是用于在运行中的系统验证功能的开发技能,而非仅依赖单元测试。它将规范要求转为可观察的检查项,并记录结果、风险及回归测试。

主要功能

  1. 01生成关联需求的验收清单
  2. 02测试运行中的 API 和界面
  3. 03记录结果与未解决风险
  4. 04将通过项纳入带标签的测试

适用场景

  1. 01合并分支前验证功能
  2. 02核对 API 响应与客户端预期
  3. 03确认界面提交后数据已保存

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jayden-dang/skills --skill acceptance-check

安装后在 Claude Code 中输入/acceptance-check确认已加载。

详细介绍

验收检查

单元测试通过,只能证明有人编写的断言通过了,不能证明功能正常。两者之间的差距——API 返回 201,而客户端读取的是 200;复选框只在内存中切换,却没有写入存储;表单在提交失败后被清空——正是功能带着缺陷发布的地方。此技能旨在弥补这一差距:驱动正在运行的系统,而不是测试套件。

在 code-review 之后、finish-branch 之前运行。

1. 根据规格制定验收清单

阅读功能的 requirements.md、design.md 和 tasks.md。针对每项描述用户可观察行为的需求,列出具体检查项——包括正常路径和每项边界条件/错误标准——并标注对应的需求 ID。规格是依据:没有人特意告诉你的行为仍然需要验证;没有追踪到的行为是需要提出的缺口,不能跳过。

将清单写入 .skills/<slug>-acceptance.md(作为工作记录,不纳入 git),并为每项创建一个待办事项。阅读量太大?派遣扫描子 Agent 梳理受影响的范围,并将要点整理到工作记录中;保持当前上下文精简。完成标准:每个面向用户的需求 ID 至少有一项具体、可观察且包含预期结果的检查。

2. 按范围分派

清单按行为所在的位置拆分。根据实际情况执行相应项——大多数功能两项都需要:

  • 变更暴露了客户端调用的 HTTP/RPC API → 必需子技能:使用 acceptance-api。
  • 变更包含用户操作的前端 → 必需子技能:使用 acceptance-ui。
  • 行为既不是 API,也不是 UI(例如 CLI、库、批处理/cron 作业)→ 亲自针对正在运行的系统直接验证,将每项观察结果记录到工作记录中,并将通过的检查纳入已提交、带 ID 标记的测试中。对于需要人工观察的特性(视觉效果、手感),交由 dogfood 处理。

按路径将清单中相应的部分交给每个子任务;它们会将结果写回同一个文件。

3. 闭环

报告清单及每项观察结果。任何无法验证的项目都是尚未解决的风险——明确指出,不要悄然放行。然后交回给 finish-branch。完成标准:清单中的每项都已在运行中的系统上观察到通过;每项失败都已修复并补充回归测试;持久化测试已提交并标记,以便 finish-branch 的验证门禁持续强制执行。

评论

支持 Markdown