技能 api-organization

🔗

api-organization

Name: api-organization
Author: BOM-98

安全 ⚙️ 外部命令🌐 網路存取🔑 環境變數📁 檔案系統存取

Организуйте API с паттерном из 5 файлов

Код API становится разбросанным и непоследовательным в кодовой базе. Этот навык предоставляет стандартизированный паттерн из 5 файлов для организации API эндпоинтов, типов и клиентов с полной безопасностью TypeScript и контролем доступа на основе ролей.

支援: Claude Codex Code(CC)

📊 70 充足

下載技能 ZIP

在 Claude 中上傳

前往設定 → 功能 → 技能 → 上傳技能

開啟並開始使用

測試它

正在使用「api-organization」。 Как организовать эндпоинты API для новой функциональности 'expenses'?

預期結果:

Создайте эти файлы в src/lib/api/:
• endpoint-types.ts - Определите типы Expense и CreateExpenseDto, добавьте в интерфейсы EndpointParams/Responses/Bodies
• endpoints.ts - Добавьте expenses: { list, get, create, update, delete } функции, возвращающие URL
• api-client.ts - Использует getAuthHeaders() для автоматического извлечения токена Supabase
• admin-api-client.ts - Добавьте checkAdminPermission() для операций только для администраторов
• protected-endpoints.ts - Экспортируйте объект api.expenses с функциями-обёртками с безопасными типами

安全審計

安全

v5 • 1/16/2026

Pure documentation skill containing only markdown files with architectural guidance. All static findings are false positives triggered by code examples in documentation blocks. No executable code, network calls, file system access beyond its own files, or code execution capabilities exist. The backticks, environment variable references, and URLs detected are documentation examples, not actual shell commands, credential access, or network requests.

已掃描檔案

1,502

分析行數

發現項

審計總數

風險因素

⚙️ 外部命令 (235)

🌐 網路存取 (7)

references/endpoints-pattern.md:104 references/endpoints-pattern.md:212 references/supabase-auth-integration.md:241 references/supabase-auth-integration.md:245 references/supabase-auth-integration.md:248 skill-report.json:6 SKILL.md:356

🔑 環境變數 (18)

📁 檔案系統存取 (1)

skill-report.json:6

審計者: claude 查看審計歷史 →

品質評分

架構

100

可維護性

內容

社群

100

安全

規範符合性

你能建構什麼

Настройка архитектуры API

Изучите паттерн из 5 файлов для организации кода API в проектах Next.js с Supabase auth.

Применение стандартов API

Установите последовательную структуру API в команде с паттернами безопасности типов и доступом на основе ролей.

Документирование потоков аутентификации

Поймите, как Supabase auth интегрируется с клиентами API для автоматической аутентификации.

試試這些提示

Добавить новый эндпоинт

Покажите, как добавить типы в endpoint-types.ts для новой доменной области 'transactions' с CRUD операциями. Включите типы params, responses и body.

Определить URL эндпоинтов

Как мне структурировать endpoints.ts для ресурса 'budgets'? Покажите паттерн для операций list, get, create, update и delete.

Создать функции-обёртки

Создайте функции-обёртки в protected-endpoints.ts для доменной области 'categories'. Включите автоматическую аутентификацию через Supabase.

Добавить доступ администратора

Как добавить эндпоинт только для администраторов в домене 'users'? Покажите паттерн admin-api-client с проверкой ролей.

最佳實務

Определите все типы TypeScript перед реализацией функций эндпоинтов для безопасности типов
Используйте getAuthHeaders() в api-client для автоматического извлечения токена доступа Supabase
Вызывайте checkAdminPermission() перед любыми операциями API только для администраторов
Храните URL эндпоинтов в одном централизованном файле для удобства обслуживания

避免

Жёсткое кодирование URL вместо использования констант API_ENDPOINTS
Пропуск определений типов и использование 'any' для ответов API
Прямые вызовы API без использования обёртки protected-endpoints
Забывание вызывать checkAdminPermission() перед административными операциями

常見問題

Работает ли этот навык с другими провайдерами аутентификации?

Да. Паттерн из 5 файлов не зависит от системы аутентификации. Замените getAuthHeaders() на извлечение токена вашего провайдера аутентификации.

Каково максимальное количество поддерживаемых эндпоинтов?

Нет жёсткого ограничения. Каждый домен в endpoint-types.ts отображается в endpoints.ts. Добавьте столько доменов, сколько нужно.

Как интегрироваться с существующим кодом API?

Перенесите URL в endpoints.ts, определите типы в endpoint-types.ts, замените вызовы fetch на обёртки apiGet/apiPost.

Безопасно ли хранятся мои данные API?

Паттерн использует httpOnly куки Supabase и политики RLS. Безопасность зависит от правильной конфигурации Supabase.

Почему моя проверка администратора не проходит?

Убедитесь, что таблица users имеет правильные значения ролей. Вызывайте checkAdminPermission() перед административными операциями. Проверьте наличие сессии пользователя.

Чем это отличается от стандартного fetch?

Этот паттерн добавляет безопасность типов, централизованную аутентификацию, доступ на основе ролей и последовательную обработку ошибок для всех вызовов API.

開發者詳情

作者

BOM-98

授權

MIT

儲存庫

https://github.com/BOM-98/FinTracker/tree/main/.claude/skills/api-organization

引用

main

檔案結構

📁 references/

📄 endpoint-types-pattern.md

📄 endpoints-pattern.md

📄 supabase-auth-integration.md

📄 SKILL.md