技能 backend-api

📦

backend-api

Name: backend-api
Author: DevanB

内容修订 r1 安全 ⚙️ 外部命令📁 文件系统访问

构建 RESTful 后端 API

后端 API 工作常常会在路由、版本控制和响应标准上停滞不前。此技能会指导 Claude、Codex 和 Claude Code 进行一致的 REST 端点设计与实现。

支持: Claude Codex Code(CC)

🥉 79 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求

Review the Skillstore skill "backend-api" from https://skillstore.io/skills/devanb-backend-api.md and its manifest at https://skillstore.io/api/skills/devanb-backend-api/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/devanb-backend-api.md 已签名 manifest GET /api/skills/devanb-backend-api/manifest 已签名 lockfile GET /api/skills/devanb-backend-api/lockfile

测试它

正在使用“backend-api”。创建一个用户列表端点。

预期结果:

为 users 资源使用 GET 集合端点。
当请求有效时返回成功状态。
在添加自定义搜索行为之前，支持分页和可选筛选器。

正在使用“backend-api”。审查订单端点的版本控制。

预期结果:

该审查会比较路径版本控制和标头版本控制，标记不一致的路由名称，并推荐单一的版本控制模式。

正在使用“backend-api”。向 API 计划添加速率限制指导。

预期结果:

输出会定义超出限制的请求的限流预期、响应标头和错误行为。

安全审计

安全

v10 • 2026/7/9 打开版本化报告

Four external command findings are false positives because they are Markdown inline code formatting for routes and paths. The filesystem finding is confirmed because SKILL.md points to ../../../agent-os/standards/backend/api.md, which directs the agent outside the skill package. No prompt injection or malicious data-exfiltration intent was found.

已扫描文件

分析行数

复核项

已忽略误报

能力复核项 (1)

这些是真实的本地能力，对此技能可能是预期行为，因此需要复核，但不会按已确认恶意行为计分。

高

SKILL.md:27

Path traversal sequence

[backend API](../../../agent-os/standards/backend/api.md)

The Markdown link uses ../../../ to instruct the agent to consult a file outside the skill package. That out-of-package filesystem reference can cause unbundled local file reads and weakens package integrity.

风险因素

⚙️ 外部命令 (4)

SKILL.md:12 SKILL.md:13 SKILL.md:14 SKILL.md:17

📁 文件系统访问 (1)

SKILL.md:27

审计者: codex 查看审计历史 →

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

https://skillstore.io/skills/devanb-backend-api/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/devanb-backend-api/security.svg)](https://skillstore.io/skills/devanb-backend-api?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/devanb-backend-api?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/devanb-backend-api/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/devanb-backend-api.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

学术引用 (APA · BibTeX · CFF)

APA 引用

DevanB. (2026). backend-api security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/devanb-backend-api/audits/10

BibTeX 引用

@techreport{devanb-devanb-backend-api-2026,
  author = {DevanB},
  title = {backend-api security audit report (audit version 10)},
  institution = {Skillstore},
  year = {2026},
  number = {10},
  url = {https://skillstore.io/skills/devanb-backend-api/audits/10},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "backend-api security audit report (audit version 10)"
version: "unspecified"
type: report
authors:
  - name: "DevanB"
date-released: "2026-07-09"
url: "https://skillstore.io/skills/devanb-backend-api/audits/10"
identifiers:
  - type: other
    value: "skillstore:devanb-backend-api:audit:10"
    description: "Skillstore immutable audit report identifier"

比较变体

2 个可安装变体

每位作者的技能都保持为独立的可安装项。推荐变体按 Skillstore 证据排序。

为什么此变体排名第一

Skillstore 评分最高

作者 / 来源 Skillstore 评分证据置信度 Skillstore 使用量已更新

DevanB 推荐当前

devanb-backend-api

Skillstore 评分 79

证据置信度高

Skillstore 使用量 44

已更新

2026-09-09

EIS-ITS

eis-its-backend-api

Skillstore 评分 78

证据置信度高

Skillstore 使用量 17

已更新

2026-09-09

Skillstore 评分

评分依据证据置信度: 高

架构

可维护性

内容

社区

规范符合性

你能构建什么

创建 REST 端点

为新的后端资源规划路由、控制器、HTTP 方法和响应代码。

标准化 API 响应

在各个端点之间对齐分页、筛选、排序、错误和资源格式化。

审查 API 变更

检查端点设计是否符合 REST 约定、版本控制选择和限流预期。

试试这些提示

创建基础端点

为此资源设计一个 REST 端点。包括路由用途、HTTP 方法、控制器操作、预期状态码和响应形状。

添加查询行为

为此 API 端点添加筛选、排序、分页和搜索行为。解释查询参数和验证规则。

设计版本化资源

为此 API 资源规划版本控制。比较 URL 路径版本控制和基于标头的版本控制，然后推荐一种方法。

审查 API 表面

审查这些 API 路由和控制器是否符合 REST 约定、版本控制、状态码、分页和速率限制。按优先级列出修复项并说明理由。

最佳实践

保持资源名称一致，并为每个操作使用标准 HTTP 方法。
在实现之前定义分页、筛选、排序和搜索行为。
将成功和错误路径映射到清晰的 HTTP 状态码。

避免

在标准 HTTP 方法已经能描述操作时，仍将自定义动词混入 URL。
返回会掩盖真实请求结果的通用成功或错误代码。
为每个端点以不同方式添加版本控制、筛选或限流行为。

常见问题

此技能最适合哪些框架？

它最适合 Laravel 风格的后端项目，尤其是包含 API 路由、控制器和资源类的项目。

它能生成完整的 API 代码吗？

它可以指导实现，但不包含可执行的脚手架或项目特定的测试生成。

它是否支持 API 版本控制决策？

可以。它在设计层面涵盖 URL 路径版本控制和基于标头的版本控制。

它能帮助处理分页和筛选吗？

可以。它包含关于筛选、排序、分页和搜索查询参数的指导。

它是否涵盖安全控制？

它提到了速率限制和限流，但不是完整的 API 安全审查技能。

为什么会有 marketplace 安全警告？

该技能引用了其包之外的文档文件。作者应将该文件打包到技能内部。

开发者详情

作者

DevanB

许可证

MIT

Skillstore 修订

版本提示

作者未声明版本。

仓库

https://github.com/DevanB/lucidlog/tree/master/.claude/skills/backend-api

引用

0519034dad657fb1f7706e0550e962beeda73fdf

维护新鲜度

2026/7/26

使用量

7 次下载 · 226 次浏览

文件结构

设计可靠的智能体工具

由 Asmayaseen

当工具名称、输入、输出或错误信息含糊不清时，智能体就会失败。此技能为工具描述、schema、响应格式和测试提供实用模式。

编码与开发查看

backend-api

使用我的智能体安装

Agent 可读资源

测试它

安全审计

风险因素

复制报告链接

Markdown 徽章

HTML 徽章

嵌入卡片

APA 引用

BibTeX 引用

CITATION.cff

比较变体

Skillstore 评分

你能构建什么

创建 REST 端点

标准化 API 响应

审查 API 变更

试试这些提示

最佳实践

避免

常见问题

开发者详情

DevanB 的更多技能

global-conventions

global-commenting

backend-models

frontend-components

backend-migrations

backend-queries

相关技能

api-design

laravel-expert

python-fastapi-patterns

api-designer

senior-backend

tool-design