4.9 KiB
4.9 KiB
삼국지 슬링샷 (가제) — 에이전트 작업 지침
너드나비스 조직 프로젝트 ⑤ (조직 레포
.claude/skills/너드나비스-코어룰/rules/P38.md§P38-3 ⑤). 새 세션은 조직 레포공유/인계서/삼국지슬링샷_인계서.md→ 이 파일 →README.md순서로만 읽고 시작한다. 조직 규칙 본문 전수 읽기 금지(C10-1).
프로젝트 정보
- Unity 6000.3.23f1 · 2D · 빌트인 RP · 레거시 Input(
activeInputHandler: 0) · Portrait · 패키지 = 기본 모듈 +com.unity.ugui 2.0.0+com.unity.test-framework 1.6.0+com.unity.pipeline 0.10.0-exp.1(2026-11-04 P38-7 적용). - git = 이 폴더가 레포 루트 ·
main· 원격 없음(PD 지시 시 생성). 미추적 =Library/Temp/Logs/UserSettings/obj/(Unity 표준.gitignore· Pipeline 포트 파일Library/Pipeline/.unity-pipeline-port도 그 안). - 기록 = 조직 레포
공유/대화로그/삼국지슬링샷/· 인계서공유/인계서/삼국지슬링샷_인계서.md· PD 지시 로그 #1077.
에디터 제어 = Unity 공식 CLI + com.unity.pipeline (P38-7)
기본 호출은 MCP 가 아니라 셸에서 unity … 직접 호출이다(Unity 공식 권장 · 토큰 적음). unity 명령은 PowerShell 로 호출하되, C# 코드에 큰따옴표가 들어가는 eval 류는 Bash 도구로(K-DEV-026). 에디터가 둘 이상 열려 있으면 --project-path E:\Nerdnavis\ThreeKingdomsSlingshot 또는 환경 변수 UNITY_PROJECT_PATH 로 대상을 지정한다(K-DEV-024).
에디터가 열려 있을 때 (PD 플레이 중 반복 수정)
unity status --project-path . # ready 확인(포트·PID)
unity recompile --project-path . # 수정 후 재컴파일 · 컴파일 오류 0 이어야 통과
unity command --project-path . # 등록된 명령 목록(콘솔 읽기 · 메뉴 실행 등)
unity command --project-path . <명령> [인자] # 명령 실행 · --result-only 로 JSON 만
unity test . --mode PlayMode --output <xml> # 열린 에디터에서 테스트
unity close . [--force] # 에디터 종료(저장 없이 종료 · PD 가 연 에디터는 닫지 않는다)
- PD 가 Play 중이면
Assets/쓰기·리컴파일 금지(편집 모드 조사·패치 준비만). 수정을 모두 끝낸 뒤 리컴파일 1회. - 판정 = 컴파일 오류 0 + 콘솔 error 0(Unity 자체
SearchDatabase인덱싱 예외는 무해).
에디터가 닫혀 있을 때 (배치 · 재현 가능한 실측)
Unity.exe -batchmode -nographics -projectPath <proj> -executeMethod TKS.EditorTools.ProjectSetup.Build -quit -logFile <log> # 컴파일 + 설정 자산·씬 생성(BuildFresh = 기본값 재시드)
Unity.exe -batchmode -nographics -projectPath <proj> -runTests -testPlatform PlayMode -testResults <xml> -logFile <log> # 플레이모드 테스트(현재 14종)
Unity.exe -projectPath <proj> -executeMethod TKS.EditorTools.ProjectSetup.AutoPlayCapture -autoplayDir <dir> -autoplayTurns 3 # GUI 자동 플레이 캡처 · 스스로 종료
Unity.exe=C:\Program Files\Unity\Hub\Editor\6000.3.23f1\Editor\Unity.exe. 에디터가 같은 프로젝트를 열고 있으면 배치 실행은 못 한다(Temp/UnityLockfile) — 먼저unity status로 확인.- 배치 로그 판정 =
error CS0 · 테스트 XMLfailed="0".
코드 규칙
- 수치·영웅·스테이지 SOT =
Assets/Resources/BalanceConfig.asset(Inspector 조정 · 최초 시드만Assets/Scripts/Editor/BalanceDefaults.cs). 코드·테스트에 수치를 직접 적지 않는다(C45). - 규칙 해석 변경 =
Assets/Scripts/Runtime/ActionResolver.cs(병종 4종) ·BattleManager.cs(턴·승패·창병 대기) ·Combat.cs(피해 공식·경로 질의). 변경 시Assets/Tests/PlayMode/BattleFlowTests.cs에 테스트 추가 후 14종 이상 전부 통과 확인. - 콜라이더 질의 전
Physics2D.SyncTransforms()· 유닛 제거는SetActive(false)후Destroy· 자식 렌더러가 있는 표시물은 GameObject 통째로 끈다. - 아트 교체 지점 =
UnitView.cs몸통 원(다른 세션의 원화·애니 → 스프라이트/스켈레탈). - 보고는 실측·추정·미확인을 분리한다(C23 · C5). 커밋은 의도 변경 파일만.
구조 (README 와 동일)
Assets/Scripts/Runtime/—GameBootstrap(씬 구성) ·BattleManager·ActionResolver·Combat·SlingshotInput(조작·스크롤·줌) ·CameraController(넓은 전장 카메라) ·EnemyAI(교전 범위) ·BattleHUD(HUD·미니맵) ·Unit/UnitView·Board·Fx·AutoPlayDriverAssets/Scripts/Editor/—ProjectSetup(CLI 진입점·씬 생성) ·BalanceDefaults(최초 시드)Assets/Tests/PlayMode/—BattleFlowTests.claude/skills/— Unity CLI 에이전트 스킬(unity skill install claude-code --local산출물 · 재설치는unity skill refresh)