Files
AX-Copilot-Codex/docs/DEVELOPMENT_2026-04-04_CONTINUOUS.md
lacvet 8cb08576d5 AX Agent 도구·스킬 정합성 재구성 및 실행 품질 보강
변경 목적:
- AX Agent의 도구 이름, 내부 설정, 스킬 정책, 실행 루프 사이의 불일치를 줄이고 전체 동작 품질을 높인다.
- claw-code 수준의 일관된 동작 품질을 참고하되 AX 구조에 맞는 고유한 카탈로그·정규화 레이어로 재구성한다.

핵심 수정사항:
- 도구 canonical id, legacy alias, 탭 노출, 설정 카테고리, read-only 분류를 중앙 카탈로그로 통합했다.
- ToolRegistry, AgentLoopService, 병렬 실행 분류, 권한 처리, 훅 처리, 스킬 allowed-tools 해석이 같은 이름 체계를 사용하도록 정리했다.
- Agent 설정/일반 설정/도움말의 도구 카드와 훅 편집기, 스킬 설명을 현재 런타임 구조에 맞게 갱신했다.
- 컨텍스트 압축, intent gate, spawn agents, session learning, model prompt adapter, workspace context 관련 변경과 테스트 추가를 함께 반영했다.
- 문서 이력과 비교/로드맵 문서를 최신 상태로 갱신했다.

검증 결과:
- dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\verify_toolcat\ -p:IntermediateOutputPath=obj\verify_toolcat\ : 경고 0 / 오류 0
- dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter AgentToolCatalogTests -p:OutputPath=bin\verify_toolcat_tests\ -p:IntermediateOutputPath=obj\verify_toolcat_tests\ : 통과 8
2026-04-14 17:52:46 +09:00

55 lines
2.2 KiB
Markdown

# 연속 진행 기록 (2026-04-04)
## 1) 안정화 점검 결과
- 빌드: `dotnet build` 성공 (경고 0, 오류 0)
- 테스트: `dotnet test` 성공 (425 passed, 0 failed)
## 2) 설정-런타임 연동 확인
아래 설정값은 런타임 코드 경로에서 실제 참조됨.
- `MaxRetryOnError`
- 사용: `AgentLoopService` 재시도 상한
- `EnableProactiveContextCompact`
- 사용: 수동/자동 compact 판단 경로
- `ContextCompactTriggerPercent`
- 사용: compact 임계치 계산
- `MaxContextTokens`
- 사용: LLM 요청 `max_tokens`/`maxOutputTokens`
- `VllmAllowInsecureTls`
- 사용: vLLM HTTP 호출 TLS 검증 우회 분기
- `AgentUiExpressionLevel`
- 사용: slash 도움말/필터 가시성/설정 화면 표현 수준
## 3) 도구/스킬 상태 스냅샷
- `IAgentTool` 구현 클래스 수: 83
- `ToolRegistry.Register(...)` 호출 수: 84
- `skills/*.skill.md` 파일 수: 41
- Slash 명령 매핑 엔트리 수: 85
## 4) OpenCode 비교 포인트 (실행 반영 기준)
- OpenCode 문서 기준 핵심 slash: `/permissions`, `/mcp` 확인
- AX 현재 매핑에 `/permissions`, `/allowed-tools`, `/mcp`, `/chrome`, `/compact` 포함
- 다음 보강 우선순위:
1. 수동 시나리오 기반 MCP/Chrome 진단 품질 강화
2. Internal/External 정책 전환 시 외부 도구 차단/허용 회귀 테스트
3. 권한 모드 전환과 도구 실행 결과의 사용자 피드백 일관화
## 5) 다음 연속 작업 큐 (실행 순서)
1. 수동 시나리오 체크리스트 4건 완료
2. 실패 시나리오 로그 정형화 및 메시지 개선
3. 설정 항목 도움말 문구를 표현 수준별(풍부/적절/간단) 차등 노출
4. 도구/스킬 비교 리포트 자동 생성 스크립트 추가
## 6) 추가 검증 반영 (2026-04-04 2차)
- 테스트 보강:
- `LlmRuntimeOverrideTests`
- `ResolveServerInfo_VllmGlobalInsecureTls_ShouldBeApplied`
- `ResolveServerInfo_RegisteredModelOverride_ShouldUseEndpointAndApiKey`
- `ChatWindowSlashPolicyTests`
- `/compact` 파싱 케이스 추가
- 부분 회귀 실행:
- OperationMode/Compact/RuntimeOverride 관련 45건 통과
- 남은 수동 항목:
- 실제 사내 vLLM 엔드포인트 연결 성공 확인
- `/compact` 실행 후 UI 토큰/요약 표시 갱신 확인