跳到正文
cccskills
免费在 GitHub 公开中文介绍

api-and-interface-design

为REST或GraphQL API、模块边界和组件属性设计稳定、易预测的接口,涵盖契约、校验、统一错误格式、分页及安全重试。

原文查看原文说明

Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.

LeoYeAI/agent-master-skills星标 2,193(GitHub 2,193 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • 设计新API
  • 明确模块间契约
  • 评估公开接口变更

中文介绍

功能

本技能为系统各部分之间的接口设计提供指导,包括REST和GraphQL API、模块边界以及组件属性。它建议在开始实现前先约定输入和输出契约,统一命名与错误格式,并在系统边界校验外部输入。内容还涉及列表API的分页、以较少破坏现有使用方的方式添加字段,以及用类型表达不同状态。对于可避免重试导致重复处理的幂等键,资料说明了键的选择方式、重复请求的处理方法和保存期限。

适用场景

设计新API或明确团队之间的交接约定时,可以使用本技能。准备修改已公开的接口时,也可借此评估兼容性以及对使用方的影响。

使用示例

  • “请为任务管理API设计输入、输出和错误格式。”
  • “请为这个REST API提出分页和部分更新方案。”
  • “请检查这次接口变更可能影响哪些现有使用方。”

注意事项

资料没有将这些指导限定在特定实现方式或框架中。

本介绍由 AI(OpenAI Codex)根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果(实测对比)。

安全性发送数据、删除文件、执行命令等是否有说明
A良好资料要求在边界校验输入,并避免错误响应泄露内部信息。
安装难易度所需工具和 API 密钥是否少且有说明
A良好资料未指定必需工具、API密钥或操作系统。

不计入评分。 由 AI(OpenAI Codex)于 2026年11月15日 评估。仅供参考,安装前请同时查看原文。

如果您认为评估有误,请申请复核

请写明哪一项有误以及原因。无需登录。我们会对照 SKILL.md 重新评估,并在此处更新结果。

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

包含的文件(1)

  • SKILL.md14.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

0codekit

免费有简介

通过Membrane CLI连接0codekit工作区数据,可处理表格、数据库、任务、日历、邮件、聊天消息和文档等信息;请求不明确时需补充应用或数据细节。

  • 处理0codekit工作区信息
  • 查看表格或数据库数据
  • 查询任务和日历活动
LeoYeAI/agent-master-skills21932026年11月1日 更新

0xarchive

免费有简介

通过0xArchive API查询Hyperliquid、Lighter.xyz和HIP-3的历史及当前市场数据,包括价格、订单簿、交易、资金费率、未平仓量和清算,并检查数据更新时间与覆盖范围。

  • 查询支持交易所的历史价格
  • 查看订单簿和交易记录
  • 跟踪资金费率与未平仓量
LeoYeAI/agent-master-skills21932026年11月1日 更新

12-factor-apps

免费有简介

依据12-Factor App的12项原则检查代码库,逐项评估配置、依赖和日志等方面,并提供文件与行号证据、问题说明及按优先级排列的改进建议。

  • 审查SaaS应用架构
  • 排查云迁移前的配置问题
  • 容器化前检查应用
LeoYeAI/agent-master-skills21932026年11月1日 更新

13-Day Sprint Method

免费有简介

以玛雅历为灵感,用13天一个周期推进个人或团队项目。每天的“音调”提示行动重点,涵盖设定目标、执行、发布成果、整理和复盘。

  • 用13天推进个人项目
  • 为团队冲刺安排每日重点
  • 查询今天的行动提示
LeoYeAI/agent-master-skills21932026年11月1日 更新

13c-metabolic-flux

免费有简介

根据稳态碳13示踪测量估算细胞内代谢通量,检查碳原子映射和测量输入,模拟标记分布并拟合受约束的通量,以判断数据能约束哪些通路反应速率。

  • 根据碳13测量估算代谢通量
  • 检查原子映射与测量输入
  • 根据指定通量预测标记分布
LeoYeAI/agent-master-skills21932026年11月1日 更新

1688 Sourcing Agent

免费有简介

此技能按步骤指导你通过 1688.com 选品、核查供应商、申请样品、议价并比较运输方式,也会梳理商品信息和付款风险,以及何时应咨询采购专家。

  • 核查 1688.com 供应商
  • 按预算筛选商品
  • 议价或申请样品
LeoYeAI/agent-master-skills21932026年11月1日 更新

查看 LeoYeAI 的全部技能

报告此技能的问题