fchastanet/ai-linter

ai-linter은(는) 무엇을 하나요?

AI Linter는 AI 스킬과 에이전트 구성을 검증하는 도구입니다. SKILL.md 및 AGENTS.md 파일의 구조, 프론트매터, 콘텐츠 길이, 토큰 제한, 파일 참조를 강제합니다. YAML 설정, pre-commit, VS Code 통합을 포함하여 AI 프로젝트에서 강력하고 자동화된 린팅을 제공합니다.

주요 기능

• 구조 검증: SKILL.md와 AGENTS.md 파일이 올바른 구조와 프론트매터를 가지고 있는지 확인합니다.
• 콘텐츠 검증: 파일의 콘텐츠 길이와 토큰 제한을 확인합니다.
• 참조 검증: 파일 내 참조된 파일이 실제로 존재하는지 확인합니다.
• 자동화 통합: YAML 구성, pre-commit 훅, VS Code 확장을 통해 자동화된 린팅을 지원합니다.

설치 및 사용법

YAML 구성

프로젝트 루트에 .ai-linter.yml 파일을 생성합니다:

rules:
  - name: "frontmatter-check"
    enabled: true
  - name: "content-length"
    enabled: true
    max_length: 10000
  - name: "token-limit"
    enabled: true
    max_tokens: 2048
  - name: "file-reference-check"
    enabled: true

pre-commit 통합

.pre-commit-config.yaml에 다음을 추가합니다:

repos:
  - repo: https://github.com/fchastanet/ai-linter
    rev: v1.0.0
    hooks:
      - id: ai-linter
        args: ["--config", ".ai-linter.yml"]

VS Code 확장

VS Code 마켓플레이스에서 "AI Linter" 확장을 설치하고 설정에서 활성화합니다.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 도구

라이선스

MIT