API 测试与协作指南(Bruno)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-api-test-collaboration-guide。
技能介绍
要解决什么问题
团队做 API 开发与联调时,常见痛点不是「缺一个 HTTP 客户端」,而是没有可复用的协作约定:PR 里改接口没人按同一套清单看;Bruno 集合怎么组织、环境变量怎么交接没有文档;REST 契约、错误码、版本策略各写各的,联调时再扯皮。线上接口报错时,也容易在「直接改代码」和「凭感觉猜根因」之间浪费时间。
本技能把通用工程能力落到 API 测试与 Bruno 协作场景:用结构化输入换可执行的交付物,而不是泛泛聊天。
技能如何工作
技能通过触发词路由到六项能力,典型对应关系如下:
- 代码评审:输入 diff/PR,输出带阻断/建议/可选分级的检查清单(正确性、安全、可维护性优先于风格)。
- API 设计 / 契约:输入资源与操作,输出 RESTful 规范、字段契约与错误码草案。
- 调试排错:输入报错与上下文,输出定位树、最小复现步骤与修复验证路径。
- 技术方案 / 架构权衡:输入需求与约束或场景规模,输出背景/目标/选型/风险模板或利弊对比表。
- 工程规范:结合语言/框架,给出清单与常见反模式。
内置两条工作流可直接套用:代码评审(读意图 → 正确性/安全/可维护性 → 分级结论)与线上排错(稳定复现 → 隔离变量 → 证据 → 假设验证 → 回归复盘)。另有技术方案模板、评审检查清单与五维代码质量量表,便于在 Bruno 相关的接口变更、集合维护场景中直接填写。
适用边界与注意点
技能提供的是方法论、模板与检查清单,不接入付费服务,不代管密钥或外部账号;涉及凭证时仅给脱敏示例。评审与方案结论为辅助参考,合并与上线决策仍由负责人承担。若你的诉求超出 API 测试协作(例如纯 UI 测试、性能压测工具链),应结合其他工具与规范使用。
使用场景
- 评审同事改动的 OpenAPI/路由与 handler 的 PR,需要按正确性、鉴权与错误码一致性输出分级意见
- 为新微服务写技术方案,要在背景、目标、Bruno 集合划分与环境策略之间做选型并写清回滚
- 接口线上 5xx,手里只有日志片段与请求示例,需要最小复现路径和隔离环境/版本/数据的排查顺序
- 前后端对齐新资源时,要把 CRUD 路径、字段命名、幂等与统一错误码整理成可联调的契约草案
适合人员
- 维护 Bruno 集合并与多人共享环境变量的后端工程师,希望 PR 与文档交接有固定清单
- 负责接口版本与错误码规范的技术负责人,联调前要先出契约再写实现
- 全栈开发者独自维护小项目 API,需要在改接口时同时自检安全边界与测试覆盖
- DevOps 或 SRE 在告警后协助开发,需要把「复现—证据—回归」步骤写成可跟跑的排错记录