AFSIM-SKILL | v1.0.2
English | 중국어
처음 사용하시나요? 단 3단계로, 3분 만에 완료합니다.
MCP 프로토콜을 구현한 모든 IDE(예: Cursor / Trae / VSCode + Continue / Claude Desktop)를 지원합니다.
첫 사용 방법 (3단계)
1단계: 디렉토리 열기
Cursor 또는 Trae에서 AFSIM-SKILL/ 디렉토리를 프로젝트 루트 디렉토리로 엽니다.
IDE는 다음을 자동으로 인식합니다:
.cursor/commands/ 아래의 명령어 진입점(/afsim, /afsim-auto, /afsim-learn, /afsim-debug) (참고: Trae의 경우 .trae 폴더로 조정해야 합니다)SKILL.md — AI 행동 규범
2단계: 대화 시작하기
IDE의 AI 대화 창에 다음을 입력합니다:
그러면 명령어 목록과 빠른 시작 안내를 볼 수 있습니다.
3단계: 하위 명령어 선택
| 명령어 | 적용 시나리오 |
|---|
/afsim-auto | AFSIM 시나리오 코드의 빠른 생성 (완전 자동) |
| ... | |
기능
- AFSIM 코드 생성: 템플릿과 공식 Demo를 기반으로 정확하고 오류가 적습니다.
- 명령어 기반 상호작용:
/afsim-auto 완전 자동 / 반자동 / /afsim-learn 문서 분석 / /afsim-debug 오류 처리
- 점진적 공개 (Progressive Disclosure): 기본적으로 핵심 파일만 로드하고, 필요에 따라 상세 문서를 읽어와 컨텍스트 점유율을 최소화합니다.
- 2단계 교훈 시스템: 조건 반사식 오류 인덱싱 + 스트레스 활성화 심층 교훈
- 템플릿 라이브러리: 기초부터 고급까지, 복사하여 바로 사용 가능합니다.
- 확장성: GUI 플러그인 매개변수 설정, 더 많은 Demo 분류, 지속적인 교훈 축적
경험 학습 시스템
AFSIM-SKILL은 사용자가 수동으로 경험 학습을 추가할 수 있도록 지원하며, 2단계 구조를 통해 점진적인 오류 방지 기능을 구현합니다:
2단계 구조
| 레벨 | 파일 | 설명 |
|---|
| 인덱스 | refs/errors-ref.md | 일반적인 오류에 대한 빠른 인덱싱 (조건 반사) |
| 교훈 | memory/cold/ | 심층 교훈, 스트레스 활성화 (인덱스를 통해 접근한 후에 로드됨) |
교훈 라이브러리
핵심 파일:
memory/cold/lesson-root-causes.md — 교훈 본체 (3가지 주요 근본 원인으로 분류)memory/cold/lesson-index.md — 교훈 인덱스 (빠른 위치 파악)
세 가지 주요 근본 원인 분류:
| 분류 | 설명 |
|---|
| 블록 구조 오류 | end_* 누락, 블록 중첩 오류 등 |
| ... | |
교훈 축적
새로운 오류를 만나고 수정할 때마다 다음을 수행합니다:
- 오류 패턴과 수정 방안을
refs/errors-ref.md에 추가합니다.
- 해당 오류에 심층적인 근본 원인이 있다면, 대응하는 교훈을 생성하여
memory/cold/에 추가합니다.
황금률
근거 없이 AFSIM 문법을 임의로 만들지 말고, 검증된 템플릿과 공식 Demo를 기반으로 출력해야 합니다!
프로젝트 구조
AFSIM-SKILL/
├── SKILL.md # AI 행동 규범 (핵심 진입점)
├── .cursor/
...
자주 묻는 질문
“Skill을 인식하지 못했습니다”라는 메시지가 표시됩니다.
Cursor/Trae에서 AFSIM-SKILL/ 디렉토리를 프로젝트 루트 디렉토리로 열었는지 확인해 주십시오.
오류 처리 기능이 작동하지 않나요?
반드시 /afsim-debug 명령어를 사용하고, 전체 오류 정보(Warlock/Wizard의 오류 메시지 텍스트 포함)를 붙여넣었는지 확인하십시오.
소개
AFSIM-SKILL은 해공병기가 정리 및 개발했으며, AFSIM 공식 문서와 방대한 실전 사례를 참고했습니다.
해공병기는 Command 시리즈와 AFSIM 등 현대 전술 보드게임 시뮬레이션(wargame simulation) 도구의 AI 지원 개발에 주력하며 다음을 제공합니다:
- CMO-HKBQSKILL(Command Lua 코드 생성)
- AFSIM-SKILL(AFSIM 시나리오 코드 생성)
- 실전 병기 튜토리얼 및 사례 공유
해공 병기와 AI 공식 계정을 팔로우하고, [병추회] 지식 성운에 참여하여 학습을 교류하세요.
라이선스
본 프로젝트는 MIT License를 채택한 오픈 소스이며, 상업적 이용이 환영됩니다.
업데이트 로그
2026-05-26 | v1.0.2
[E019] weapon을 platform 인스턴스에 작성했을 때의 오류 교훈 추가[E020] 출력 파일 상대 경로 관련 오류 교훈 추가 (AFSIM 시작 디렉토리를 기준)[L014] weapon 선언 위치 관련 교훈 추가[L015] 출력 파일 경로 관련 교훈 추가- 2단계 교훈 체계 완성
2026-05-25 (두 번째 업데이트)
- 성과 관리 폐쇄 루프 추가: output/ 디렉토리, 임시 → 검증 → 성숙 3단계 관리 시스템 구현
output/staging/ 임시 성과 구역 추가output/verified/ 성숙 성과 구역 추가 (scenario / component / template 세 가지 유형)- 코드 생성 출력 방식을 파일 쓰기로 변경, 더 이상 코드 블록을 직접 출력하지 않음
- afsim-auto, afsim-learn, afsim-debug 명령어 파일 업데이트
2026-05-25 (초기 버전 출시)
- 초기 버전 배포
/afsim-auto 전자동/반자동 코드 생성 지원/afsim-learn 문서 파싱 통합 지원/afsim-debug 오류 처리 + 2단계 교훈 체계 지원- 점진적 공개 전략을 통해 컨텍스트 사용 최소화
MIT 라이선스 하에 배포 · 해공 병기