1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ln-42-acceptance-test-builder(合集仓库 levnikolaevich/claude-code-skills 内的子技能) |
| 作者/维护者 | levnikolaevich |
| 来源链接 | https://github.com/levnikolaevich/claude-code-skills/tree/master/plugins/testing-suite/skills/ln-42-acceptance-test-builder |
| 许可证 | MIT(GitHub API 实测) |
| GitHub Stars | 522(GitHub API 实测,数字属整个合集仓库,不代表本技能自身热度,详见第 6 章) |
| Forks | 74(GitHub API 实测) |
| 最新版本 | v2026.07.12(2026-07-13 发布,将仓库重构为当前“18 个独立技能”架构的起点) |
| 安装方式 | 插件市场一条命令安装所在的 testing-suite 套件 |
2. 功能介绍与亮点
ln-42-acceptance-test-builder 是一个把已确定的验收标准落地为可执行、可复现测试代码的实施工具:面向“需求和测试范围都已经理清,现在要真正写出能跑的验收测试”这一具体环节。
核心流程分五步:确定改动边界(需求、受保护结果、允许改动的路径与非目标,无法安全落地时直接返回 BLOCKED)→ 设计可复现的验收证据(每条需求对应受保护结果、缺陷类型与独立判定依据,优先贴近生产形态的边界而非单元级模拟)→ 在测试范围内实现(复用项目既有测试框架与目录习惯,只新增测试与必要文档,不改动被测的生产代码)→ 执行并保留证据(记录确切命令、环境、退出码,若暴露产品缺陷则保留失败证据如实报告,而不是改实现让测试通过)→ 收尾给出 COMPLETE/INCOMPLETE/BLOCKED 结论。
主要亮点:明确的改动边界护栏(明文禁止部署、发布、迁移共享数据、轮换凭据,或为了通过而接受被改变的输出);证据保真(保留首次失败现场,不许用重试掩盖不确定性或放宽断言凑通过);发现缺陷时的正确姿态(停止改实现、保留证据、报告最小复现路径);项目原生优先(沿用仓库已有测试框架而非引入新抽象)。
3. 适用场景
所属分类:工程效率与代码质量
适合团队已经明确了某个需求的验收标准(无论是人工写出来的,还是由 ln-41-test-strategy-planner 产出的优先级测试矩阵),需要把这些标准变成真实可运行、可复现、可留存证据的测试代码——尤其适合需要证明“这条需求确实按预期工作”的交付节点。它不做测试策略设计,也不做代码库横切审计,专注在“把验收标准写成能跑的测试”这一实施环节。
4. 跨 Agent 兼容性
- Claude Code:原生支持——插件市场一条命令安装。
- Codex:原生支持——该插件套件配备独立的
.codex-plugin/plugin.json清单。 - OpenClaw:未验证——现有材料未提及。
- Hermes Agent:未验证——现有材料未提及。
5. 推荐理由
写验收测试时最容易出现两种问题:为了让测试通过而放宽断言、跳过失败用例甚至反过来改动生产代码;以及测试证据本身不可复现,下次运行结果不一致却查不出原因。本技能把这两类问题变成显式的执行契约:遇到真实缺陷时“停止改实现、保留证据、报告缺陷”,而不是想办法让测试变绿;同时强制记录确切命令与环境,保证证据可复现。对已经理清验收标准、只差落地为可运行测试的团队,这是把“验收测试”从口头承诺变成留痕证据的实施工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 所属合集仓库 522 Stars / 74 Forks(GitHub API 实测,数字属整个合集,不代表本技能自身热度);该子目录由同一开发者持续打磨,最近一次提交为 3 天前(2026-07-24,“Refine outcome-first review skills”);GitHub Issue 搜索未发现专门针对本技能的独立第三方反馈 |
| 可用性 | 8 | 插件市场一条命令即可安装所在套件;SKILL.md 文档结构完整(工具路由表、分阶段检查清单、输出格式规范齐全),最近一次提交为 3 天前;不涉及任何付费依赖或外部账号 |
| 安全性 | 8 | 见下方检查清单;相比同套件的纯只读技能,本技能会创建/修改测试文件,故安全性略低于纯只读工具 |
安全检查清单: ① 权限范围——仅通过项目已有的测试框架与命令执行测试,写操作限定在“测试文件与必要的测试文档”范围内,SKILL.md 明文禁止修改被测的生产代码、禁止部署/发布/迁移共享数据/轮换凭据; ② 联网外发——仅在验证外部契约/规范文档时查阅官方资料,不外发用户数据; ③ 凭据处理——不需要任何 API Key 或凭据,明文禁止在测试中处理生产凭据轮换; ④ 可疑指令——全文核验未发现提示注入或混淆代码迹象; ⑤ 作者信誉——单一独立开发者持续维护,未见刷星或 SEO 操纵措辞; ⑥ License——MIT,明确; ⑦ 最近维护——3 天前有提交,活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| ln-41-test-strategy-planner(同仓库姊妹技能) | 纯只读测试策略设计,产出风险驱动的优先级测试矩阵,不写代码 | 是本技能的上游:ln-41 决定“该测什么、测到什么级别”,本技能负责落地为可运行代码;两者可独立触发,也可前后接续 |
| lackeyjb/playwright-skill(2,952 Stars) | 专精浏览器自动化,模型自主编写并执行 Playwright 脚本完成 UI 测试 | 只覆盖浏览器这一种验证边界;本技能沿用项目已有的任意测试 runner(UI/API/CLI/消息层),适用范围更广但对单一框架的专精不及专用工具 |
| Trail of Bits 出品的 property-based-testing | 判断函数是否该写属性测试(往返、幂等、不变量等),给出多语言生成路径 | 是单一测试技术的专精指南,产出通用不变量断言;本技能面向已知验收标准逐条落地为确定性场景测试,只在需要不变量判定时才涉及类似断言 |
8. 用户评价
该技能所属的当前架构上线时间较短,第三方平台目前尚无针对该技能本身的具名用户评价。
9. 其他补充
安装同一插件套件会一并获得姊妹技能 ln-41-test-strategy-planner——它负责在动手写测试前先产出风险驱动的测试策略,两者是“先定策略、再写测试”的前后接续关系,也可各自独立触发。
10. 安装使用方式
- 在 Claude Code 或 Codex 中执行:
/plugin marketplace add levnikolaevich/claude-code-skills - 再执行:
/plugin install testing-suite@levnikolaevich-skills-marketplace - 安装后无需重启,在对话中直接描述“帮我把这份验收标准写成可运行的测试”等类似意图即可触发,无需额外配置。
11. 注意事项
- 本技能会创建/修改测试文件与必要的测试文档,使用前建议确认工作区处于可回滚状态(如独立分支或 worktree)。
- 若测试暴露产品缺陷,技能只保留失败证据并报告,不会反过来“修复”实现代码,缺陷仍需使用者自行处理。
- 该仓库历史上经历过多次整体架构调整,当前架构自 2026 年 7 月中旬起保持稳定但仍在活跃迭代,子技能路径未来可能变动。
- 安装命令会一并引入同套件内的 ln-41-test-strategy-planner,只需要本技能时可留意是否有更细粒度的安装方式。
- SKILL.md 未使用
allowed-tools字段做技术级工具限制,改动边界依赖指令层面约束而非强制沙箱。