跳转到主要内容
此内容尚未提供您的语言版本,正在以英文显示。

Improving DRF Endpoints

技能 活跃

Use when editing, reviewing, or auditing DRF viewsets and serializers in PostHog. Triggers on files in posthog/api/, products/*/backend/api/, products/*/backend/presentation/, or any file importing rest_framework. Covers field typing, schema annotations, enum collision fixes, and OpenAPI spec quality — everything that flows downstream into generated TypeScript types and MCP tools.

目的

Improve the quality and accuracy of DRF viewset and serializer definitions to ensure correct type generation for frontend, MCP tools, and API documentation.

功能

  • Audits DRF viewsets and serializers.
  • Covers field typing, schema annotations, and OpenAPI spec quality.
  • Ensures correct TypeScript types and MCP tool compatibility.
  • Provides guidance on `help_text`, `ListField`, `JSONField`, `SerializerMethodField`, and choice fields.
  • Details best practices for `@validated_request` and `@extend_schema` decorators.

使用场景

  • Editing or reviewing files defining DRF `Serializer` or `ViewSet`.
  • Fixing OpenAPI spec warnings or generated type issues.
  • Preparing an endpoint for MCP tool exposure.
  • Code review of API changes for type accuracy.

非目标

  • Directly modifying or executing code.
  • Performing automated code fixes.
  • Reviewing non-DRF code or general Python code.

工作流

  1. Identify relevant DRF serializer or viewset files.
  2. Audit generated types and API schema for issues.
  3. Review serializer fields for `help_text`, typed lists/JSON, and explicit choices.
  4. Verify viewset methods have appropriate schema annotations (`@validated_request` or `@extend_schema`).
  5. Ensure correct response serializers and error types are defined.
  6. Apply recommended patterns and fix anti-patterns.

实践

  • API Design
  • Code Quality
  • Type Safety
  • OpenAPI Specification

Trust

  • warning:Issues AttentionThere are 544 open issues and 163 closed issues in the last 90 days, indicating a low closure rate and potentially slow response times.

安装

npx skills add PostHog/posthog

通过 npx 运行 Vercel skills CLI(skills.sh)— 需要本地安装 Node.js,以及至少一个兼容 skills 的智能体(Claude Code、Cursor、Codex 等)。前提是仓库遵循 agentskills.io 格式。

质量评分

79 /100
1 day ago 分析

信任信号

最近提交1 day ago
GitHub 所有者 PostHog (opens in new tab)
星标34.5k
下载量 0 (opens in new tab)
许可证MIT-0
网站posthog.com(opens in new tab)
状态
查看源代码

类似扩展

Google Docs

100

Interact with Google Docs - create documents, search by title, read content, and edit text. Use when user asks to: create a Google Doc, find a document, read doc content, add text to a doc, or replace text in a document. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

技能
sanjay3290

Django Framework

65

Django full-featured Python web framework with batteries included (ORM, admin, auth)

技能
bobmatnyc

X Twitter Scraper

100

当用户需要通过 Xquik 获取 X (Twitter) 数据或执行需要确认的 X 操作时使用：推文搜索、用户查找、关注者提取、媒体下载、监控、Webhook、MCP、SDK、发布、点赞、私信和个人资料更新。需要 Xquik API 密钥。切勿索要 X 登录凭据。

技能
Xquik-dev

Slack

100

Use the Slack tool to react, pin/unpin, send, edit, delete messages, or fetch Slack member info.

技能
steipete

Github

100

Use gh for GitHub issues, PR status, CI/logs, comments, reviews, releases, and API queries.

技能
steipete

Product Self Knowledge

100

Stop and consult this skill whenever your response would include specific facts about Anthropic's products. Covers: Claude Code (how to install, Node.js requirements, platform/OS support, MCP server integration, configuration), Claude API (function calling/tool use, batch processing, SDK usage, rate limits, pricing, models, streaming), and Claude.ai (Pro vs Team vs Enterprise plans, feature limits). Trigger this even for coding tasks that use the Anthropic SDK, content creation mentioning Claude capabilities or pricing, or LLM provider comparisons. Any time you would otherwise rely on memory for Anthropic product details, verify here instead — your training data may be outdated or wrong.

技能
SeifBenayed