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

2.2 KiB

연속 진행 기록 (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 토큰/요약 표시 갱신 확인