AgentSkillsCN

code-quality

修复 lint 错误、格式化代码、运行类型检查、评估代码质量。适用于修复 lint 问题、格式化 Python 代码、运行 ruff 工具、执行 ty 检查、验证 TypeScript 类型，或确保代码质量时使用。

SKILL.md
--- frontmatter
name: code-quality
description: Fix lint errors, format code, run type checking, check code quality. Use when fixing linting issues, formatting Python, running ruff, running ty, checking TypeScript types, or ensuring code quality.
allowed-tools: Bash, Read, Edit, Grep, Glob

Code Quality

Handles all code quality tasks for the CCBell Sound Generator project including linting, formatting, and type checking.

Project Stack

  • •Backend (Python): FastAPI with ruff for linting/formatting and ty for type checking
  • •Frontend (TypeScript): React 19 with ESLint and TypeScript compiler

Available Commands

Backend Linting (ruff)

bash
cd backend && source venv/bin/activate && ruff check .

To auto-fix issues:

bash
cd backend && source venv/bin/activate && ruff check --fix .

Backend Formatting (ruff)

Check formatting:

bash
cd backend && source venv/bin/activate && ruff format --check .

Apply formatting:

bash
cd backend && source venv/bin/activate && ruff format .

Backend Type Checking (ty)

bash
cd backend && source venv/bin/activate && ty check .

Frontend Linting (ESLint)

bash
cd frontend && npm run lint

To auto-fix:

bash
cd frontend && npm run lint -- --fix

Frontend Type Checking (TypeScript)

bash
cd frontend && npx tsc --noEmit

Full Quality Check

Run all checks in sequence:

bash
cd backend && source venv/bin/activate && ruff check . && ruff format --check . && ty check .
cd frontend && npm run lint && npx tsc --noEmit

Important Notes

  • •Virtual environment is at backend/venv (created by uv sync --group dev)
  • •Backend uses ruff with 100 char line length and double quotes
  • •Always run quality checks before committing
  • •These checks are enforced in the CI pipeline