前言¶
新功能立项时，接口往往先以口头约定或零散笔记存在：路径怎么定、请求体字段叫什么、错误码是否复用、版本怎么演进，往往在联调或评审阶段才暴露不一致。手写 OpenAPI 或内部 Wiki 能兜底，但从「业务一句话」到「可评审的完整设计」仍要反复补路由、结构与错误体系。
下面介绍 SkillHub 上的社区 Skill app-designer-weii（@user_d0ecbcbf/app-designer-weii，v1.0.0）。它面向 RESTful / RPC 场景，在对话中根据业务需求生成接口设计文档，并覆盖路由规划、请求/响应结构、错误码与版本策略，并对设计合理性做检查。标签标明 requires_api_key=false，无需额外 API Key 即可使用。
这是什么¶
app-designer-weii 是 RESTful/RPC API 设计助手：根据业务需求生成符合团队规范的接口设计文档，包括路由规划、请求/响应结构、错误码体系、版本策略，并自动检查设计合理性。
- 坐标：
@user_d0ecbcbf/app-designer-weii - 版本：1.0.0
- 来源：community（发布者
user_d0ecbcbf） - 分类：dev-programming
- 官方页面：SkillHub - app-designer-weii
- API 入口：https://api.skillhub.cn/user_d0ecbcbf/app-designer-weii
SkillHub 页面展示的统计（以页面为准，会随时间变化）：评分 100000，下载 778，安装 1。
核心功能¶
依据官方简介，该 Skill 在 Agent 侧主要承担以下工作（均为文档与设计层面的输出，不替代实际编码实现）：
- 路由规划：按 RESTful 或 RPC 风格梳理资源与调用路径。
- 请求/响应结构：定义入参、出参字段与类型层面的结构说明。
- 错误码体系：整理业务与通用错误码的划分与含义。
- 版本策略：说明接口版本演进方式（如路径前缀、Header 等层面的约定）。
- 合理性检查：对生成方案做一致性、可维护性等方面的自检，减少明显设计漏洞。
若团队已有内部 API 规范（命名、分页、鉴权头、错误码段），应在对话中一并说明，以便输出贴近「符合团队规范」的目标。
安装与启用¶
该 Skill 基于通用 SKILL.md 格式，需安装到当前 Agent 能识别的 skills 目录；装错目录会导致 Agent 无法加载。
方式一：通过 SkillHub CLI¶
先确认本机是否已安装 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装说明 执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 app-designer-weii 时，必须用 --dir 指向当前环境的 skills 目录。例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub install @user_d0ecbcbf/app-designer-weii --dir ~/.cursor/skills/
其他常见路径（摘自官方安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。请按你实际使用的客户端选择目录。安装后若 Agent 未立即识别，可按客户端说明重启或刷新技能列表。
方式二：让 AI 按官方指引安装¶
SkillHub 页面提供的安装提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d0ecbcbf/app-designer-weii`。
将上述内容发给支持 Skill 安装的 AI 客户端，由 Agent 按文档完成 CLI 检查、--dir 安装与目录校验。
典型用法¶
官方页面未附带独立示例仓库；可复现的流程如下：
- 按上一节完成安装，并在 Cursor、Claude Code 等客户端中确认 app-designer-weii 已加载。
- 在新对话中描述业务背景：涉及哪些资源、核心操作、调用方（Web / 移动端 / 内部服务）、是否需要 RPC 而非纯 REST 等。
- 补充团队约束：鉴权方式、分页/排序字段命名、统一响应包裹结构、错误码区间、是否要求 URL 版本号等。
- 明确要求输出完整接口设计文档，并点名需要覆盖的章节（路由、请求/响应、错误码、版本策略）。
- 根据 Skill 简介中的「自动检查设计合理性」，可追加一步：请对照上述约束列出潜在冲突或遗漏项。
经过上面的步骤，你应得到一份可直接进入评审或转为 OpenAPI/内部模板的结构化设计说明，而不是零散的 endpoint 列表。
适用场景与注意¶
适合谁
- 需要在早期对齐接口契约的后端、全栈或架构角色。
- 多服务协作、希望先统一错误码与版本策略再写代码的团队。
- 希望用对话快速起草 REST 或 RPC 设计稿、再人工细化的场景。
限制与注意
- 来源为 community，维护节奏与详细规则以 Skill 包内 SKILL.md 为准；安装后可在 skills 目录中查看完整指引。
- 输出质量依赖你在对话中给出的业务细节与团队规范；Skill 不会自动读取你们仓库里的既有规范文件，除非你在上下文中说明或粘贴要点。
- 设计文档需经人工与评审流程确认后再落地实现；自动化检查针对的是设计合理性，不能替代安全审计、性能压测或合规审查。
- 页面统计中的下载、安装数为 SkillHub 侧数据，仅作参考，不代表某个具体团队的采纳情况。
结尾¶
app-designer-weii 把「从业务需求到可评审 API 设计」收敛成可重复的 Agent 工作流：路由、结构、错误码与版本策略一次成形，并带合理性检查。无需 API Key 即可安装使用。
官方 Skill 页面：https://www.skillhub.cn/skills/user_d0ecbcbf/app-designer-weii
API 地址：https://api.skillhub.cn/user_d0ecbcbf/app-designer-weii
