AgentSkillsCN

dev-health-check

在重大重构、依赖项变更之后,或在新机器上首次部署时,快速验证仓库是否处于可运行状态(依赖项已安装、代码格式检查与构建顺利通过、开发服务器响应正常)。

SKILL.md
--- frontmatter
name: dev-health-check
description: "Quickly verify the repo is in a runnable state (deps installed, lint/build pass, dev server responds). Use after major refactors, dependency changes, or when onboarding to a new machine."
argument-hint: "Optional: port (default 8080)"
user-invocable: true

Dev Health Check

When to use

  • After pulling changes / rebasing
  • After editing shadcn/ui primitives or Tailwind config
  • Before starting a playtest session

Procedure

  1. Install dependencies (if needed)
  2. Run lint
  3. Run production build
  4. (Optional) If dev server is running, verify it responds on port 8080

Helper script (PowerShell)

  • Run powershell -File .github/skills/dev-health-check/scripts/dev-health.ps1 -Port 8080

Notes

  • ESLint may emit react-refresh/only-export-components warnings in src/components/ui/*; treat warnings as acceptable unless they become errors.