audit-hooks

Agent Skills › trycompai/comp › audit-hooks

audit-hooks

GitHub

审计并修复代码中的 Hook 和 API 使用模式，消除过时的 server actions、raw fetch 等反模式。强制替换为 SWR 和自定义 Hook，确保数据获取与缓存失效合规，并通过类型检查验证修复结果。

.agents/skills/audit-hooks/SKILL.md trycompai/comp

Trigger Scenarios

需要审计前端 Hook 和 API 调用规范时发现使用了 useAction、raw fetch 或 useEffect 进行数据获取时需要批量重构客户端组件以符合 SWR 最佳实践时

Install

npx skills add trycompai/comp --skill audit-hooks -g -y

More Options

Non-standard path

npx skills add https://github.com/trycompai/comp/tree/main/.agents/skills/audit-hooks -g -y

Use without installing

npx skills use trycompai/comp@audit-hooks

指定 Agent (Claude Code)

npx skills add trycompai/comp --skill audit-hooks -a claude-code -g -y

安装 repo 全部 skill

npx skills add trycompai/comp --all -g -y

预览 repo 内 skill

npx skills add trycompai/comp --list

SKILL.md

Frontmatter

{
    "name": "audit-hooks",
    "description": "Audit & fix hooks and API usage patterns — eliminate server actions, raw fetch, and stale patterns"
}

Audit the specified files for hook and API usage compliance. Fix every issue found immediately.

Forbidden Patterns (fix immediately)

useAction from next-safe-action → replace with SWR hook or custom mutation hook
Server actions mutating via @db → delete and use API hook instead
Direct @db in client components → replace with apiClient via hook
Direct @db in Next.js pages for mutations → replace with serverApi
Raw fetch() without credentials: 'include' → use apiClient
window.location.reload() after mutations → use SWR mutate()
router.refresh() after mutations → use SWR mutate()
useEffect + apiClient.get for data fetching → replace with useSWR
Callback props for data refresh (onXxxAdded, onSuccess) → remove, rely on SWR cache sharing

Required Patterns

Client data fetching: useSWR with apiClient or custom hook
Client mutations: custom hooks wrapping apiClient with mutate() for cache invalidation
Server components: serverApi from apps/app/src/lib/api-server.ts
SWR: fallbackData for SSR data, revalidateOnMount: !initialData
API response: lists = response.data.data, single = response.data
mutate() safety: guard against undefined in optimistic update functions
Array.isArray() checks: when consuming SWR data that could be stale