← 返回 Skills 市场
cnsunxuefeng

Api Design Doc

作者 cnsunxuefeng · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
255
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install api-design-doc
功能描述
标准化API接口设计文档生成工具。根据需求文档、数据库DDL等输入，进行API的标准化、规范化设计，输出完整的API接口设计文档，包括错误码规范、接口格式规范、入参出参定义、JSON示例等，指导后续的代码开发和前后端联调。使用场景包括：(1) 根据业务需求设计RESTful API接口，(2) 基于数据库DDL生...
使用说明 (SKILL.md)

API Design Doc

根据需求文档、数据库DDL等输入，生成标准化的API接口设计文档。

工作流程

  1. 收集输入信息

    • 获取需求文档或业务需求描述
    • 获取数据库DDL（如果适用）
    • 明确接口的业务场景和功能需求

  2. 页面功能与API接口关系

    • 明确页面功能与API接口的对应关系

  3. 设计API接口

    • 确定接口的RESTful风格（GET/POST/PUT/DELETE）
    • 定义接口URL路径
    • 设计入参和出参结构
    • 选择合适的错误码

  4. 生成接口文档

    • 使用标准模板生成每个接口的详细文档
    • 包含功能描述、入参、出参、URL、请求方式、JSON示例

  5. 输出完整文档

    • 页面功能与API接口关系
    • 汇总所有接口文档
    • 包含错误码规范总表
    • 提供接口格式规范说明

参考资料

错误码规范

参见 error-codes.md - 完整的错误码列表和说明

接口文档模板

参见 api-spec-template.md - 标准的API接口文档格式

命名规范

参见 naming-conventions.md - API命名和参数命名规范

最佳实践

参见 best-practices.md - API设计最佳实践

模板文件

API文档模板

使用 templates/api-doc-template.md 作为单个接口文档的模板

API响应模板

使用 templates/api-response-template.json 作为标准响应格式参考

使用指南

当用户请求设计API接口时：

  1. 首先读取 error-codes.md 了解错误码规范
  2. 根据业务需求设计接口，参考 best-practices.md
  3. 使用 api-spec-template.md 的格式生成每个接口文档
  4. 确保命名符合 naming-conventions.md 的规范
  5. 输出完整的API设计文档，包含所有接口和错误码总表

输出格式

接口文档必须包含以下部分：

  1. 错误码规范总表
  2. 接口格式规范说明
  3. 页面功能与API接口关系表，包含以下内容：
    • 页面名称：前端页面或功能模块的名称
    • 页面功能描述：页面或功能模块的简要说明
    • 关联API接口：该页面调用的API接口列表（API-Id）
    • 操作类型：GET/POST/PUT/DELETE等HTTP方法
    • 接口URL：完整的API路径
  4. 接口清单与详细定义，详细定义的规范如下：
  • 接口编号（API-Id）：顺序生成，格式为 API001-接口名称，如 API001-用户登录, API002-获取用户列表, ...
  • 功能描述：详细描述接口的功能和用途
  • 入参：参数类型和说明（标注必填/可选）
  • 返回参数：返回值类型和说明
  • URL地址：完整的API路径
  • 请求方式：GET/POST/PUT/DELETE
  • 接口 JSON 示例：完整的请求和响应JSON示例

输出位置

  • 仅生成一份API文档，保存在项目根目录下的 doc/ 目录。
  • 若 doc/ 目录不存在，应自动创建该目录后再写入文档。
  • 文档文件名固定为：API接口设计文档.md，内容包含：
  • 错误码总表（来自 references/error-codes.md）
  • 接口格式规范（来自 references/api-spec-template.md 的说明部分）
  • 页面功能与API接口关系表（按页面或功能模块归类）
  • 接口清单与详细定义（按模块归类的所有接口条目）
安全使用建议
This skill appears coherent and only uses its bundled templates and docs to generate a single API design file. Before installing/using it, be aware that the agent will create a `doc/` directory (if missing) and write `API接口设计文档.md` to your project root — review the generated file before committing. Because it can write files, avoid running it in sensitive system directories or repos with secrets. No credentials or network downloads are required by the skill itself.
功能分析
Type: OpenClaw Skill Name: api-design-doc Version: 1.0.0 The skill bundle is a legitimate tool designed to generate standardized API documentation from user inputs like requirements and database DDLs. It uses local reference files (e.g., references/error-codes.md, references/naming-conventions.md) and templates to guide the AI agent in creating consistent API designs, which are then saved to a local 'doc/' directory. No indicators of malicious intent, data exfiltration, or harmful command execution were found.
能力评估
✓ Purpose & Capability
Name/description (API design document generator) align with the provided templates, reference docs, and instructions. No unrelated binaries, environment variables, or external services are requested.
ℹ Instruction Scope
Runtime instructions tell the agent to read the included reference files and generate a single file saved to project-root `doc/API接口设计文档.md`. This is coherent with the skill's purpose, but it does include writing to the user's project filesystem (creating `doc/` if missing).
✓ Install Mechanism
Instruction-only skill with no install spec and no downloaded code — lowest install risk.
✓ Credentials
No environment variables, credentials, or config paths are requested. All materials used are bundled with the skill.
✓ Persistence & Privilege
always is false and the skill does not request persistent platform privileges. The only side effect is creating/writing a documentation file under the project's `doc/` directory as described.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install api-design-doc
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /api-design-doc 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- 首发版本，提供API接口设计文档标准化生成工具。 - 支持根据需求文档、数据库DDL等输入，自动生成规范化API设计文档。 - 文档输出涵盖错误码规范、接口格式、入参出参定义、JSON示例等必备内容。 - 包含详细工作流程、参考资料、标准模板使用说明及最佳实践指引。 - 生成文档自动保存在 doc/API接口设计文档.md。
元数据
Slug api-design-doc
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Api Design Doc 是什么？

标准化API接口设计文档生成工具。根据需求文档、数据库DDL等输入，进行API的标准化、规范化设计，输出完整的API接口设计文档，包括错误码规范、接口格式规范、入参出参定义、JSON示例等，指导后续的代码开发和前后端联调。使用场景包括：(1) 根据业务需求设计RESTful API接口，(2) 基于数据库DDL生... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 255 次。

如何安装 Api Design Doc？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install api-design-doc」即可一键安装，无需额外配置。

Api Design Doc 是免费的吗？

是的，Api Design Doc 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Api Design Doc 支持哪些平台？

Api Design Doc 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Api Design Doc？

由 cnsunxuefeng（@cnsunxuefeng）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论