SuperAPI AI 工具集

agent-friendly-apis

编程与开发

查看项目

更新于 10-16 01:06

技能介绍

用途:作为 Vercel Academy“Agent-Friendly APIs”课程的配套技能,引导学习者完成从构建 API 到文档自动化生成的完整流程。

主要能力与课程结构:课程共 12 课、3 个部分。第一部分构建 API:搭建带 TypeScript 的 Next.js 项目,创建 /api/feedback 的 GET 与 POST 处理器、查询参数过滤与 /[id] 动态路由、/summary 聚合统计端点。第二部分让 API 对智能体友好:介绍七种文档模式(代码块中的端点签名、Markdown 参数表、带真实值的 curl 示例、完整响应体、详尽错误文档、Schema 表、多端点工作流示例),并添加 /llms.txt、/llms-full.txt、/api/docs.md 三个机器可读文档路由,随后部署验证。第三部分构建技能:学习 Claude Code 技能的 SKILL.md 结构与渐进式披露,编写五步文档生成器(发现路由、分析路由、读取类型、生成 Markdown、写入输出),运行、评估并迭代。

使用方式:技能提供 /agent-friendly-apis learn、/agent-friendly-apis new、/agent-friendly-apis submit 三个命令,分别用于启动引导学习、脚手架搭建新项目、按当前课程评估实现。技能有三种模式并在任意模式间切换:TA 模式(默认,被动答疑)、Teaching 模式(主动取课、逐步引导)、Evaluation 模式(对照课时清单检查代码库并报告通过/失败)。课程内容来自 https://vercel.com/academy/agent-friendly-apis.md 及对应课时 .md 文件。

适用场景:学习构建供 AI 智能体使用的 API 与其文档、编写 llms.txt 标准文档、制作 Claude Code 文档生成技能。

限制:具体收费、价格等信息暂未提供;内容与命令细节以课程资料为准。