用途:当用户提出 API 设计、端点、REST API、URL 等问题(如“设计一个……的 API”)时,使用该技能生成完整、可投产的 REST API 端点规范。
主要能力:先询问用户需要“仅端点”还是“详细设计”(若用户已说明需求细节则不再询问)。仅端点模式只输出端点列表;详细设计模式按资源分组输出,包含方法、路径、简短说明、请求头表、请求体 JSON(字段名、类型、说明,标注必填/可选)、成功响应及状态码、相关错误码。默认使用 RESTful 约定:集合用复数名词、关系用嵌套路径(如 /hotels/{id}/rooms);默认 Bearer JWT 鉴权,第三方集成可用 X-Api-Key,公开端点明确标注;路径默认加 /api/v1/ 前缀;列表端点包含 page、limit、sort、filter 等查询参数,并使用分页信封(data 加 pagination 的 total、page、limit、totalPages)。覆盖主要资源,推断用户未列出的资源,包含 CRUD 及领域特定操作。完成后询问是否生成 API 文档;若已安装 API Documentation 技能则按其说明以纯文本输出,否则提示未安装并可选生成基础文档。
使用方式:按技能内联指引执行;可参考 references/domains.md 获取各领域预置资源清单,参考 references/testmu_example.md 生成结构与示例。
限制:上述两个参考文件为外部前置材料,未随目录打包,需从声明的上游来源或用户安装处获取并核验许可与执行前提;文件不存在时不得运行相关命令或声称已执行,也不得伪造缺失脚本。仅在任务与上游来源及本地项目上下文明确匹配时使用;应用变更前须验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境特定测试、安全审查或对破坏性/高成本操作的用户批准。其他具体功能、收费与平台信息暂未提供。