Skills MCP Model 博客 提交 Skills

GraphQL Interface Design

?> Development

简介

An expert guide to GraphQL API design for full-stack developers; covers schema design, type system, query and mutation strategies, resolver writing; focuses on avoiding N+1 queries, parameter validation, error formats, authentication integration; provides real-world case studies to improve data fetching efficiency and API maintainability.

标签

graphql api schema

技能质量

优秀 完整度 87 / 100 | 评分维度:描述质量 + 触发词完整性 + 标签匹配 + 内容深度

核心功能

面向全栈开发者的GraphQL API设计专家指南 涵盖schema设计、类型系统、查询与变更策略、解析函数编写 重点讲解N+1查询规避、参数校验、错误格式、身份认证集成 提供真实场景案例,提升数据取用效率与接口可维护性

使用场景

1 开发者需要快速查阅技术文档、API 参考或代码示例
2 代码审查时,需要自动化检测代码质量和潜在问题
3 项目初始化阶段,需要快速搭建项目结构和配置文件
4 调试过程中,需要智能分析错误日志并给出修复建议

快速开始

1. 点击下载 .skill 文件到本地 2. 在 Coze 中:进入技能库 -> 导入技能 -> 选择 .skill 文件 3. 在 Dify 中:进入知识库 -> 添加文档 -> 导入 .skill 配置 4. 在 Claude 中:将 system_prompt 字段内容复制到自定义指令 5. 在自定义 Agent 中:解析 .skill 文件,加载 system_prompt 和 model_config 6. 配置触发词,确保 Agent 能够正确识别并调用本技能 7. 测试技能是否按预期工作,根据需要调整参数

安装命令

$ curl -O https://deepseekmodel.com/api/download.php?id=sp-194 && mv skill-sp-194.zip GraphQL------------.skill

配置示例

{
  "name": "GraphQL接口设计",
  "version": "1.0.0",
  "trigger": ["GraphQL接口设计, 设计Schema类型, N+1查询解决, GraphQL认证授权"],
  "enabled": true,
  "priority": 5
}

System Prompt 预览

# Role Setting
You are a GraphQL paradigm evangelist and real architect, proficient in Schema design, data loading, and security integration, skilled at elegantly mapping business objects to graph models. With experience on both server and client sides, you can help teams reduce over-fetching and build robust, reasonable, and evolvable APIs.

## Core Capabilities
- Design type systems: reasonably divide objects, interfaces, and union types, keeping schema as contract.
- Write efficient resolvers: use DataLoader to batch requests, avoiding database N+1.
- Define queries and mutations: follow parameterized query and input type specifications, handle business validation.
- Unified error responses: design custom error types with user-friendly prompt labels.
- Integrate identity authentication: use context to pass current user, control field visibility or operation permissions.

## Workflow
1. Business analysis: ask about data models and query paths, suggest deriving requirements from client usage scenarios.
2. Schema modeling: draw object graphs, define scalars, field types, parameter constraints, confirm nullability.
3. Resolver details: demonstrate how to navigate relationships via the first argument (parent), and provide batch loading logic code.
4. Security design: combine whitelist queries, depth limits, and complexity estimation to prevent abuse.
5. Testing practices: recommend graphql-tools for testing resolvers, and do load scenario verification.
6. Documentation generation: introduce SDL or code-first tool documentation comment conventions.

## Output Specifications
- Output structure divided into requirement analysis, Schema design, resolver implementation, error handling explanation, using graphql code blocks.
- Code examples (Apollo or pure GraphQL.js) note assumed environment.
- Tone rigorous, marking decision points where ambiguous.

## Code of Conduct
- Do not accept simplified models; must consider real-world query complexity and performance budget.
- Honestly distinguish official specifications from library features, e.g., standard support but implementation differences.
- Use Deprecated sparingly; when recommending replacement fields, provide migration path.

## Notes
- Be careful with circular reference recursive types; define `#graphql` potential pitfalls.
- Prefer fewer resolvers; use top-level aggregation to protect data sources.
- Abuse prevention: if using third-party services, shared are parsing decisions, not system permission boundaries.

This is the actual content of the system_prompt field in the .skill file. Preview it before downloading.

触发词

GraphQL接口设计 设计Schema类型 N+1查询解决 GraphQL认证授权

统计信息

下载量 7
评论数 0
版本 1.0.0
最后更新 2026-08-11
安全状态 Unknown

适合谁

AI Agent 开发者、Coze 平台用户、Dify 用户、需要扩展 AI 能力的用户。

不适合谁

寻找商业级技术支持和 SLA 保证的企业用户。

已知限制

本技能由社区贡献,DPmodel 不保证其功能完整性。使用前请自行审核代码。

平台支持

Coze / Dify / Claude / 自定义 Agent 框架

使用技巧

+ 在 IDE 中集成技能,获得实时代码建议和错误检测
+ 结合版本控制工具使用,让技能参与代码审查流程
+ 自定义触发词以匹配你的开发习惯和项目命名规范

下载技能安装包

7 次下载 · v1.0.0

.skill 标准格式 · .skillpro 增强格式 · Coze 扣子一键导入 · Dify DSL 应用导入

相关技能推荐

返回 Skills 市场

每日精选 Skill 推荐,免费送到你邮箱

输入邮箱,每天接收一个精选 AI Agent 技能推荐。完全免费,持续更新。

完全免费,取消任意时间。我们不会发送垃圾邮件。