AgentSkillsCN

vkc-repo-guardrails

严格执行 Viet K-Connect 的各项不可妥协原则（禁止使用服务器端操作，仅支持 API 路由；遵循 Drizzle/Supabase 设计模式；采用 TanStack Query 仓库层架构；确保 ko/en/vi 语言的键值一致性）。在代码变更前后及 PR 审查时作为检查清单使用。

SKILL.md
--- frontmatter
name: vkc-repo-guardrails
description: Enforce Viet K-Connect non-negotiables (no Server Actions, API Routes only, Drizzle/Supabase patterns, TanStack Query repo layer, i18n ko/en/vi key parity). Use before/after code changes and for PR review checklists.
metadata:
  short-description: Repo guardrails + checks

Viet K-Connect Repo Guardrails

When to use

  • •You’re about to implement or review changes in this repo.
  • •You need a repeatable “PR checklist” to prevent architecture drift.

Quick start

  1. •Run local checks:
  • •bash .codex/skills/vkc-repo-guardrails/scripts/guardrails.sh
  1. •If it fails, fix violations first (especially Server Actions / i18n key drift).
  2. •For new work, follow the VKC prompt protocol: docs/CODEX_PROMPT_PROTOCOL.md

Non‑negotiables (must keep)

  • •No Server Actions: never add "use server".
  • •Server code lives in API Routes: only src/app/api/**.
  • •DB access: Drizzle via @/lib/db + @/lib/db/schema.
  • •Client data layer: src/repo/<domain>/{fetch,query,mutation,types}.ts + query keys in src/repo/keys.ts.
  • •i18n: messages/{ko,vi}.json keys stay in sync; en is allowed to be partial (ko fallback).
  • •Imports: prefer @/* alias; avoid deep ../ chains for shared modules/components.
  • •Components: ATOMIC folders + export default component pattern.

Where to look (canonical examples)

  • •API (user): src/app/api/reports/route.ts
  • •API (admin): src/app/api/admin/news/route.ts
  • •Responses: src/lib/api/response.ts
  • •Rate limit helper: src/lib/api/rateLimit.ts
  • •Repo structure rules: docs/REPO_STRUCTURE_GUIDE.md

Expected PR output (what to report)

  • •Guardrails result: PASS / FAIL + concrete violations
  • •i18n parity: PASS / FAIL
  • •Any intentional deviations: explicit rationale + follow-up task

References

  • •Repo architecture pointers: .codex/skills/vkc-repo-guardrails/references/architecture.md
  • •Conventions checklist: .codex/skills/vkc-repo-guardrails/references/conventions.md