api-and-interface-design

仓库创建 2026年7月5日最近提交 22 天前SkillHot 收录 22 天前

▸ 精选理由

适合设计 REST/GraphQL 和模块边界的开发者与架构师参考。

这个 Skill 做什么

提供稳定且不易误用的 API 与接口设计原则与实践指导。

把 API、模块边界和组件接口设计成不容易被误用的样子，让正确用法变简单、错误用法变困难。用于设计 REST、GraphQL、模块契约或前后端交互边界时。重点是接口稳定、可读并有清晰文档与保护措施，从而降低长期维护成本和误用风险。

▸ 展开 SKILL.md 英文原文

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.

开发编程接口设计API契约通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/kulapoo/opencode-agent-harness/main/skills/api-and-interface-design/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/kulapoo/opencode-agent-harness/main/skills/api-and-interface-design/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# API and Interface Design

## Overview

Design stable, well-documented interfaces that are hard to misuse. Good interfaces make the right thing easy and the wrong thing hard. This applies to REST APIs, GraphQL schemas, module boundaries, component props, and any surface where one piece of code talks to another.

## When to Use

- Designing new API endpoints
- Defining module boundaries or contracts between teams
- Creating component prop interfaces
- Establishing database schema that informs API shape
- Changing existing public interfaces

## Tech Context

Tech is declared in `rules/tech.md`. Each name maps directly to `tech/<name>/`
(e.g. `rust` → `tech/rust/`, `react` → `tech/react/`), th

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有