1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | codeception-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI（原 LambdaTest） |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/codeception-skill |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 352（数据来自 GitHub API；为整个合集仓库总量，不代表本技能自身热度） |
| Forks | 69（数据来自 GitHub API，同为合集整体口径） |
| 最新版本 | 1.0（SKILL.md front matter 自述，仓库未发布正式 Release） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
为 PHP 测试框架 Codeception 生成验收（Acceptance）、功能（Functional）、单元（Unit）三类测试代码的技能，核心是它独有的 Actor 模式（$I->amOnPage()、$I->fillField()、$I->see() 这类以“演员”为主语的 DSL），让测试代码读起来接近自然语言描述的用户操作步骤。
- Cest 用例范式：给出登录成功/失败两种典型场景的完整 Cest 类写法，含
_before钩子、字段填写、断言、URL 校验。 - Page Object（Step Object）模式：示范如何把选择器与操作封装进独立的 Page 类，与 Actor 解耦，便于用例复用与维护。
- Actor 方法速查：导航、表单操作、断言、取值（Grabber）四类常用方法一次性列全，覆盖日常验收测试的绝大多数场景。
- 9 节深度 Playbook：配套参考文档覆盖项目搭建、验收测试、API 测试（REST 模块）、Page Object、数据库测试（
haveInDatabase/seeInDatabase）、自定义 Helper、CI/CD（GitHub Actions + MySQL + Selenium + 覆盖率）、12 项常见问题排障表、14 条最佳实践清单。 - 纯参考文档形态：子目录仅含 SKILL.md 与两份 Markdown 参考文档，不含任何可执行脚本，也不强制要求任何第三方账号或凭据。
3. 适用场景
所属分类：工程效率与代码质量
已具备 PHP 基础、想让 AI 编码助手按统一规范写出 Codeception 验收/功能/单元测试的初中级 PHP 后端开发者；尤其适合“一个工具想同时覆盖端到端浏览器操作与业务逻辑单测”的中小型 PHP 项目团队——不必像搭配 PHPUnit + Behat 那样维护两套语法体系。不依赖 TestMu AI 云端服务，本地即可完整使用。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式（YAML front matter + 指令正文），仓库 README 给出配套的官方安装工具。
- Codex：❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, Copilot, Cursor, Gemini CLI”，未点名 Codex。
- OpenClaw：❓ 未验证——已抓取材料未提及。
- Hermes Agent：❓ 未验证——已抓取材料未提及。
5. 推荐理由
一份技能把 PHP 生态里验收、功能、单元三类测试统一到 Codeception 的 Actor 语法下，配套 Page Object 模式与 9 节生产级 Playbook（含 CI/CD 与数据库测试），核心路径零付费依赖、子目录不含任何脚本，安全面干净，是 PHP 测试工具链中少见的“一体化验收测试”方案。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI（原 LambdaTest）是测试云领域公认的一线厂商：累计融资超 1 亿美元、18,000+ 企业客户（含 Microsoft、OpenAI、Nvidia）、主流科技媒体多次专文报道。合集仓库整体 352 stars 属整个合集，不代表本技能自身热度；Codeception 框架本身在 PHP 测试生态有独立社区（Packagist 广泛使用），但未查到本技能自身的独立第三方评价 |
| 可用性 | 8 | composer require 一条命令安装 + bootstrap 初始化 + run 执行三步即可用；SKILL.md 含完整安装/运行示例，配套 9 节 Playbook 覆盖到 CI 集成与排障；子目录最后提交约 2026-02-23，约 5.7 个月前，未见归档或功能性问题；核心功能零付费依赖，云端执行为可选项 |
| 安全性 | 9 | 子目录仅含 SKILL.md 与两份 Markdown 参考文档，无任何脚本或可执行文件；逐份扫描未见可疑指令或隐藏外发；云端执行需显式设置 LT_USERNAME/LT_ACCESS_KEY 环境变量，文档透明、无强制要求；License（MIT）明确；作者信誉可查（TestMu AI 融资、客户量、媒体报道均可查证） |
安全检查清单：① Shell 命令——无，不含 scripts/；② 联网外发——纯本地生成测试代码，无任何外发行为；③ 凭据——云端执行需要 LT_USERNAME/LT_ACCESS_KEY，本地测试不涉及任何账号；④ 可疑指令——未发现；⑤ 作者信誉——TestMu AI，融资/客户量/媒体报道均可查证，良好；⑥ License——MIT，明确；⑦ 最近维护——约 2026-02-23，约 5.7 个月前，未见归档。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| phpunit-skill-lambdatest-agent-skills | 同池姊妹技能，面向 PHPUnit 纯单元测试 | 只覆盖单元测试层，不含浏览器级验收测试能力；本技能用同一套 Actor 语法把单元、功能、验收三层打通，团队无需额外引入浏览器自动化工具 |
| behat-skill-lambdatest-agent-skills | 同池姊妹技能，面向 Behat（Gherkin/Cucumber 风格 BDD） | 用自然语言 Given/When/Then 描述场景，需要额外维护 Step 定义映射层；本技能的 Actor 方法直接对应操作，学习路径更短，但不具备 Gherkin 那种“业务方可读”的场景描述能力 |
| capybara-skill-lambdatest-agent-skills | 同池姊妹技能，面向 Ruby 生态的 Capybara 验收测试 | 服务 Ruby/Rails 项目；本技能服务 PHP 项目，两者面向不同技术栈，非直接竞争关系 |
| laravel-dusk-skill-lambdatest-agent-skills | 同池姊妹技能，面向 Laravel 框架专属的浏览器测试工具 Dusk | 深度绑定 Laravel 框架的用户认证/数据库场景封装，迁移成本随框架锁定；本技能是框架无关的通用 PHP 测试工具，可用于任意 PHP 项目（含非 Laravel 项目） |
核心差异化在“一体化三层测试 + 框架无关”：Codeception 用同一套 Actor DSL 覆盖验收、功能、单元三个测试层级，且不绑定特定 PHP 框架，适合技术栈较为通用或尚未统一测试工具链的 PHP 团队。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；LambdaTest/agent-skills 仓库整体在 GitHub 上有真实的多贡献者协作记录。
9. 其他补充
- 支持语言：PHP。
- Page Object 一节的封装方式（静态选择器 + 构造函数注入 Actor）可直接套用到中大型项目的用例组织中。
- Deep Patterns 参考文档的“数据库测试”一节示范了
haveInDatabase/seeInDatabase/updateInDatabase三个方法的组合用法，适合需要验证数据落库结果的场景。
10. 安装使用方式
方式一：官方 CLI（仓库推荐）
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill codeception-skill方式二：手动复制（本技能不含任何脚本，直接复制目录即可）
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/codeception-skill ~/.claude/skills/安装后注意事项：复制到位后无需重启、无需注册任何账号，Agent 会在识别到 “Codeception”、$I->amOnPage、$I->see、“Cest” 等触发词时自动读取本技能内容。若需在 TestMu AI 云端跑浏览器测试，需额外设置 LT_USERNAME/LT_ACCESS_KEY 环境变量，本地测试则完全不需要。
11. 注意事项
- 本技能面向“已经决定用 Codeception”的 PHP 项目；若项目已用 PHPUnit 或 Behat 且运转良好，迁移成本需自行评估。
- Actor 模式要求先运行
bootstrap生成AcceptanceTester等类，直接照抄示例代码前需确认项目已完成初始化。 - 子目录最后提交约在 2026-02-23，约 5.7 个月前，暂未发现功能性问题，但关注长期维护节奏的团队可留意后续更新频率。