AX Agent 도구·스킬 transcript 표현을 claw-code 기준으로 정리
Some checks failed
Release Gate / gate (push) Has been cancelled

- 도구/스킬 이벤트 배지를 역할 중심 라벨로 단순화
- raw snake_case 대신 사람이 읽기 쉬운 표시명과 /skill 형식 적용
- 작업 요약 팝업의 권한/배경 작업 관측성 섹션을 debug 수준으로 제한
- parity 문서와 개발 이력 문서에 tool/skill UX 정리 기준 반영

검증 결과
- dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\verify\ -p:IntermediateOutputPath=obj\verify\
- 경고 0 / 오류 0
This commit is contained in:
2026-04-05 19:05:49 +09:00
parent 4cbe60052e
commit 8dc2841da6
4 changed files with 121 additions and 12 deletions

View File

@@ -9375,6 +9375,74 @@ public partial class ChatWindow : Window
_ => "진행 중",
};
private static string GetAgentItemDisplayName(string? rawName, bool slashPrefix = false)
{
if (string.IsNullOrWhiteSpace(rawName))
return slashPrefix ? "/스킬" : "도구";
var normalized = rawName.Trim();
var mapped = normalized.ToLowerInvariant() switch
{
"file_read" => "파일 읽기",
"file_write" => "파일 쓰기",
"file_edit" => "파일 편집",
"document_reader" => "문서 읽기",
"document_planner" => "문서 계획",
"document_assembler" => "문서 조합",
"code_search" => "코드 검색",
"code_review" => "코드 리뷰",
"build_run" => "빌드/실행",
"git_tool" => "Git",
"process" => "프로세스",
"glob" => "파일 찾기",
"grep" => "내용 검색",
"folder_map" => "폴더 맵",
"memory" => "메모리",
"user_ask" => "의견 요청",
"suggest_actions" => "다음 작업 제안",
"task_create" => "작업 생성",
"task_update" => "작업 업데이트",
"task_list" => "작업 목록",
"task_get" => "작업 조회",
"task_stop" => "작업 중지",
"task_output" => "작업 출력",
"spawn_agent" => "서브에이전트",
"wait_agents" => "에이전트 대기",
_ => normalized.Replace('_', ' ').Trim(),
};
if (!slashPrefix)
return mapped;
var slashName = normalized.StartsWith('/')
? normalized
: "/" + normalized.Replace(' ', '-');
return slashName;
}
private static bool IsTranscriptToolLikeEvent(AgentEvent evt)
=> evt.Type is AgentEventType.ToolCall or AgentEventType.ToolResult or AgentEventType.SkillCall
|| (!string.IsNullOrWhiteSpace(evt.ToolName)
&& evt.Type is AgentEventType.PermissionRequest or AgentEventType.PermissionGranted or AgentEventType.PermissionDenied);
private static string BuildAgentEventSummaryText(AgentEvent evt, string displayName)
{
var summary = (evt.Summary ?? "").Trim();
if (!string.IsNullOrWhiteSpace(summary))
return summary;
return evt.Type switch
{
AgentEventType.ToolCall => $"{displayName} 실행 준비",
AgentEventType.ToolResult => evt.Success ? $"{displayName} 실행 완료" : $"{displayName} 실행 실패",
AgentEventType.SkillCall => $"{displayName} 실행",
AgentEventType.PermissionRequest => $"{displayName} 실행 전 사용자 확인 필요",
AgentEventType.PermissionGranted => $"{displayName} 실행이 허용됨",
AgentEventType.PermissionDenied => $"{displayName} 실행이 거부됨",
_ => summary,
};
}
private IEnumerable<TaskRunStore.TaskRun> FilterTaskSummaryItems(IEnumerable<TaskRunStore.TaskRun> tasks)
=> _taskSummaryTaskFilter switch
{
@@ -10726,9 +10794,9 @@ public partial class ChatWindow : Window
AgentEventType.PermissionGranted => GetPermissionBadgeMeta(evt.ToolName, pending: false),
AgentEventType.PermissionDenied => ("\uE783", "권한 거부", "#FEF2F2", "#DC2626"),
AgentEventType.Decision => GetDecisionBadgeMeta(evt.Summary),
AgentEventType.ToolCall => ("\uE8A7", string.IsNullOrWhiteSpace(evt.ToolName) ? "도구 실행" : evt.ToolName, "#EEF6FF", "#3B82F6"),
AgentEventType.ToolResult => ("\uE73E", string.IsNullOrWhiteSpace(evt.ToolName) ? "도구 완료" : evt.ToolName, "#EEF9EE", "#16A34A"),
AgentEventType.SkillCall => ("\uE8A5", string.IsNullOrWhiteSpace(evt.ToolName) ? "스킬 실행" : evt.ToolName, "#FFF7ED", "#EA580C"),
AgentEventType.ToolCall => ("\uE8A7", "도구", "#EEF6FF", "#3B82F6"),
AgentEventType.ToolResult => ("\uE73E", "도구 결과", "#EEF9EE", "#16A34A"),
AgentEventType.SkillCall => ("\uE8A5", "스킬", "#FFF7ED", "#EA580C"),
AgentEventType.Error => ("\uE783", "오류", "#FEF2F2", "#DC2626"),
AgentEventType.Complete => ("\uE930", "완료", "#F0FFF4", "#15803D"),
AgentEventType.StepDone => ("\uE73E", "단계 완료", "#EEF9EE", "#16A34A"),
@@ -10736,6 +10804,10 @@ public partial class ChatWindow : Window
AgentEventType.Resumed => ("\uE768", "재개", "#ECFDF5", "#059669"),
_ => ("\uE946", "에이전트", "#F5F5F5", "#6B7280"),
};
var itemDisplayName = evt.Type == AgentEventType.SkillCall
? GetAgentItemDisplayName(evt.ToolName, slashPrefix: true)
: GetAgentItemDisplayName(evt.ToolName);
var eventSummaryText = BuildAgentEventSummaryText(evt, itemDisplayName);
var primaryText = TryFindResource("PrimaryText") as Brush ?? Brushes.Black;
var secondaryText = TryFindResource("SecondaryText") as Brush ?? Brushes.DimGray;
@@ -10782,6 +10854,17 @@ public partial class ChatWindow : Window
Foreground = secondaryText,
VerticalAlignment = VerticalAlignment.Center,
});
if (IsTranscriptToolLikeEvent(evt) && !string.IsNullOrWhiteSpace(evt.ToolName))
{
headerLeft.Children.Add(new TextBlock
{
Text = $" · {itemDisplayName}",
FontSize = 8.25,
FontWeight = FontWeights.SemiBold,
Foreground = primaryText,
VerticalAlignment = VerticalAlignment.Center,
});
}
Grid.SetColumn(headerLeft, 0);
// 우측: 소요 시간 + 토큰 배지 (항상 우측 끝에 고정)
@@ -10833,11 +10916,11 @@ public partial class ChatWindow : Window
// simple 모드: 요약 한 줄만 표시 (본문 로그)
if (logLevel == "simple")
{
if (!string.IsNullOrEmpty(evt.Summary))
if (!string.IsNullOrEmpty(eventSummaryText))
{
var shortSummary = evt.Summary.Length > 100
? evt.Summary[..100] + "…"
: evt.Summary;
var shortSummary = eventSummaryText.Length > 100
? eventSummaryText[..100] + "…"
: eventSummaryText;
sp.Children.Add(new TextBlock
{
Text = shortSummary,
@@ -10850,9 +10933,9 @@ public partial class ChatWindow : Window
}
}
// detailed/debug 모드: 실행 줄 아래에 얕은 설명만 표시
else if (!string.IsNullOrEmpty(evt.Summary))
else if (!string.IsNullOrEmpty(eventSummaryText))
{
var summaryText = evt.Summary.Length > 92 ? evt.Summary[..92] + "…" : evt.Summary;
var summaryText = eventSummaryText.Length > 92 ? eventSummaryText[..92] + "…" : eventSummaryText;
sp.Children.Add(new TextBlock
{
Text = summaryText,
@@ -21508,6 +21591,11 @@ private static (string icon, string label, string bgHex, string fgHex) GetDecisi
var primaryText = TryFindResource("PrimaryText") as Brush ?? Brushes.Black;
var secondaryText = TryFindResource("SecondaryText") as Brush ?? Brushes.DimGray;
var (kindIcon, kindColor) = GetTaskKindVisual(task.Kind);
var displayTitle = string.Equals(task.Kind, "tool", StringComparison.OrdinalIgnoreCase)
|| string.Equals(task.Kind, "permission", StringComparison.OrdinalIgnoreCase)
|| string.Equals(task.Kind, "hook", StringComparison.OrdinalIgnoreCase)
? GetAgentItemDisplayName(task.Title)
: task.Title;
var taskStack = new StackPanel();
var headerRow = new StackPanel
{
@@ -21526,8 +21614,8 @@ private static (string icon, string label, string bgHex, string fgHex) GetDecisi
headerRow.Children.Add(new TextBlock
{
Text = active
? $"진행 중 · {task.Title}"
: $"{GetTaskStatusLabel(task.Status)} · {task.Title}",
? $"진행 중 · {displayTitle}"
: $"{GetTaskStatusLabel(task.Status)} · {displayTitle}",
FontSize = 9.5,
FontWeight = FontWeights.SemiBold,
Foreground = active ? primaryText : secondaryText,
@@ -21549,7 +21637,7 @@ private static (string icon, string label, string bgHex, string fgHex) GetDecisi
var reviewChipRow = BuildReviewSignalChipRow(
kind: task.Kind,
toolName: task.Title,
title: task.Title,
title: displayTitle,
summary: task.Summary);
if (reviewChipRow != null)
taskStack.Children.Add(reviewChipRow);
@@ -22033,6 +22121,9 @@ private static (string icon, string label, string bgHex, string fgHex) GetDecisi
private void AddTaskSummaryObservabilitySections(StackPanel panel, ChatConversation? currentConversation)
{
if (!string.Equals(_settings.Settings.Llm.AgentLogLevel, "debug", StringComparison.OrdinalIgnoreCase))
return;
AddTaskSummaryPermissionSection(panel, currentConversation);
AddTaskSummaryBackgroundSection(panel);
}