API 测试用例生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_36090e04/apu-case-gen。
技能介绍
问题:API 测试上下文容易丢失
API 测试不只是断言,还会牵涉 endpoint 参数、鉴权、外部依赖、TypeScript client 再生成、超时、幂等和错误码映射。一次跑通后,工程师很容易忘记某个失败是临时环境问题、接口契约变化,还是需要补充测试用例。文档、聊天记录和终端输出分散在不同地方,回归测试时又常从零开始排查。
工作方式:把测试信号沉淀为可追踪记录
该技能会在项目或 workspace 根目录维护 .learnings/,将 API 测试中的错误、修正和缺失能力分别写入 ERRORS.md、LEARNINGS.md 和 FEATURE_REQUESTS.md。它强调记录 复现步骤、外部工具集成细节、优先级 和 area tag,例如 backend、tests、config。当某个 API 问题反复出现时,它要求先搜索已有条目,用 See Also 关联相似记录,并提升优先级。若某条经验具有跨文件价值,还可以被蒸馏成短规则,提升到 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md,成为后续会话可复用的项目记忆。
适用边界:更像测试记忆层
这个技能不直接替代 HTTP 客户端或测试框架,也不应被理解成自动输出完整测试套件的工具。它更适合 API 测试上下文沉淀:把失败、接口行为差异、测试缺口和重复模式整理为结构化笔记,为后续补充测试用例或生成测试逻辑提供依据。若团队需要共享,.learnings/ 可以纳入仓库;若担心敏感输出,则应默认本地化并脱敏,避免记录 token、私钥或完整环境变量。
使用场景
- 联调时外部 API 超时或鉴权失败,需要把请求、错误码和复现步骤记到 `ERRORS.md`。
- 测试中发现接口返回结构和文档不一致,需要把差异和版本上下文记录到 `LEARNINGS.md`。
- 同一组接口反复出现参数漏校验,需要关联旧条目并提升优先级,推动补充测试规则。
- 功能完成后把 API 测试中的通用约定提炼到 `AGENTS.md`,供后续会话复用。
适合人员
- 负责接口联调的测试工程师,需要把超时、鉴权失败和错误码沉淀成可追踪记录。
- 维护后端服务的工程师,需要把接口契约变化和 client 再生成规则写成团队约定。
- 使用 Claude Code 或 Copilot 写测试的工程师,需要把 API 测试经验注入 agent 上下文。
- 负责自动化回归的工程师,需要关联重复失败并判断是环境、契约还是用例缺口。