Agent Skills
返回列表
API开发工具

API开发工具

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/api-dev-2。

技能介绍

要解决什么问题

在 Agent 里做 API 相关工作时,设计说明、请求组装、调用外部服务、解析响应往往散落在多轮对话里,步骤不一致也难复现。本技能把「从设计到文档/测试/部署」这条链路收拢成 可参数化的执行流程,而不是单次即兴写代码。

技能如何工作

@zcwl/api-dev-2 的定位是 api-development 编排类 Meta-skill,核心步骤与文档一致:

  1. 构建 API 请求:根据用户输入组装参数与请求头。
  2. 调用服务接口:向目标端点发 HTTP 请求,处理响应或超时。
  3. 解析响应数据:提取关键字段,按 mode(json / text / markdown)转成可读输出。
  4. 异常与重试:支持 max_retries;可用 skip_steps 做断点续传式跳过步骤。

可选输入包括 content(待处理内容)、mode、max_retries、skip_steps。中间产物可参考文档中的 assets/api-development_template。文档还提到文件读写、标准化 API 集成,以及在安全沙箱中 execute() 类命令执行——适合把「规范产出 API」类任务串成固定流水线。

付费版在免费基础能力之上额外提供代码静态分析与质量评分、依赖漏洞检测与升级建议、批量代码审查与报告、CI/CD 集成;免费版仅覆盖表中列出的基础功能。

适用边界与注意点

  • 不适用于需要大量人工权衡的复杂决策场景(文档明确说明)。
  • 分类为 MD+execute(),依赖 Agent 内置 LLM API;功能边界写明 需要 API Key,无 Key 环境无法完整使用。
  • 网络错误、配置参数缺失、输入格式不符时,需对照技能中的错误处理表逐项排查,而不是假设工具会自动补全业务规则。

使用场景

  • 在 Cursor 里根据产品需求草拟 REST 端点后,要按统一模板生成说明并组装可执行的 HTTP 调用参数
  • 多步 API 任务中途失败,需要用 `skip_steps` 从指定步骤继续而不是从头重写整段对话
  • 要把外部服务返回的 JSON 按 `markdown` 模式整理成给同事看的接口说明片段
  • 在 Agent 对话里串联「请求构建 → 调用 → 解析」,输出结构化结果供后续测试或文档步骤使用

适合人员

  • 负责微服务接口迭代的後端工程师,希望在 Agent 里用固定参数反复跑「设计—文档—调用」同一条链路
  • 要写 OpenAPI/Markdown 接口说明但不想每轮手动拼请求头的全栈开发者
  • 在 CI 前做批量接口联调,需要把 HTTP 调用与响应解析脚本化、可重试的测试维护者
  • 使用 Claude Code/Cursor 等 SKILL.md 平台、想把 API 相关重复步骤收成 Meta-skill 的技术负责人