Openclaw용 AI 코딩 표준

AI 에이전트가 코드 품질 레드라인을 강제하고, 점진적 컨텍스트 로딩을 관리하며, 지속적인 계획 추적을 유지하기 위한 강력한 시스템입니다.

popwho

v1.0.0

Feb 24, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install ai-coding-standards

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 ai-coding-standards 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

AI 코딩 표준란 무엇인가요?

AI 코딩 표준 스킬은 컨텍스트 엔트로피를 방지하고 AI 기반 개발에서 높은 기술 표준을 유지하기 위해 설계된 전문 프레임워크입니다. Claude Code 모범 사례를 기반으로 하여 AI 에이전트가 깔끔하고 모듈화된 유지보수 가능한 코드를 생성하도록 보장하는 품질 레드라인과 자기 교정 메커니즘 세트를 제공합니다.

Openclaw Skills 내에서 이 스킬을 구현함으로써 개발자는 대화가 길어짐에 따라 에이전트의 성능이 저하되는 일반적인 '컨텍스트 비대화' 현상을 방지할 수 있습니다. 이는 광범위한 컨텍스트 범위보다 정확한 컨텍스트 적중률에 초점을 맞추며, 파일 시스템을 영속적인 작업 상태의 단일 진실 공급원으로 활용하고 자동화된 hooks를 사용하여 비준수 코드 생성을 즉시 차단하고 수정합니다.

AI 코딩 표준 활용 사례

AI 코드 생성 중에 최대 함수 길이 및 파일 크기와 같은 엄격한 기술적 임계값을 강제합니다.
버그 수정 및 리팩토링을 위해 점진적 컨텍스트 로딩을 구현하여 토큰 사용량을 줄이고 정확도를 높입니다.
영속적인 계획 파일과 체크리스트를 사용하여 여러 AI 세션에 걸쳐 복잡한 개발 작업을 재개합니다.
사전 구성된 hooks를 통해 비준수 코드 커밋을 자동으로 차단하고 거부합니다.

AI 코딩 표준 작동 원리

시스템은 정의된 품질 레드라인에 대해 AI 출력을 모니터링합니다(예: 함수 30줄 이하, 파일 800줄 이하 유지).
ContextManager는 LLM에 제공되는 정보를 동적으로 조정하여 버그 시 대상 모듈만 로드하거나 주요 아키텍처 결정 시 전체 컨텍스트만 로드합니다.
PlanTracker는 복잡한 작업을 전용 메모리 디렉토리에 동기화하여 에이전트가 진행 상황을 추적하고 파일 시스템을 사용하여 중단 지점에서 복구할 수 있도록 합니다.
HookRunner는 코딩 표준 위반 시 AI에게 즉각적인 피드백을 제공하는 자동화된 스크립트를 실행하여 가드레일 역할을 합니다.

AI 코딩 표준 설정 가이드

워크플로우에 통합하려면 먼저 프로젝트 루트에 품질 hooks를 설정하십시오:

# 품질 검사 hooks 생성
mkdir -p .git/hooks
cp pre-commit.sample .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

그런 다음 루트 디렉토리에 CLAUDE.md 파일을 생성하여 Openclaw Skills에 대한 적용 전략을 정의하십시오:

# 프로젝트 코딩 표준

## 품질 레드라인
- 함수 <= 30줄
- 파일 <= 800줄

## 로딩 전략
- 버그 수정: 관련 파일만 로드
- 리팩토링: 전체 컨텍스트 로드

AI 코딩 표준 데이터 스키마 및 분류 체계

이 스킬은 영속성을 보장하기 위해 구조화된 계층을 통해 메타데이터와 상태를 구성합니다:

구성 요소	파일 경로 / 형식	설명
메모리 상태	`/memory/tasks/*.md`	영속적인 체크리스트 및 작업 진행 추적.
규칙 설정	`CLAUDE.md`	코딩 표준 및 로딩 전략의 기본 정의.
검증	`QualityChecker` 결과	함수 길이 또는 중첩 깊이와 같은 문제를 자세히 설명하는 JSON 출력.
Hooks	`.git/hooks/`	실시간 규칙 강제를 위한 스크립트 기반 차단.