AI Assisted Review
AI가 만든 제안·요약·변경안을 사람이 검토하고 승인하는 패턴. 웹은 근거와 diff를, 모바일은 요약과 확인 흐름을 우선합니다.
마지막 업데이트 2026-06-28
쓰는 곳#
문서 초안 검토, 정책 요약 승인, 코드/디자인 변경 제안, 데이터 인사이트 확인처럼 AI 결과를 그대로 적용하지 않고 사람이 판단해야 하는 화면에 씁니다.
적용 현황#
- 기준서
- 완료
- 포털 적용
- 이 문서의 AI 검토 조합 데모에 1차 적용
- 재사용 구현
- 포털 전용 조합 데모 있음 — 패키지 API는 아직 없음
- 배포 패키지
- 미포함
- 다음 조치
- AI Workspace·문서 승인·변경 제안 화면에 반복 적용 가능성 검토
구조#
- AI 제안
- 제안 내용, 신뢰 단서, 적용 범위
- 근거
- 출처, 인용, 사용한 데이터, 제한 사항
- 비교
- 현재 상태와 제안 후 상태의 diff
- 결정
- 승인, 부분 적용, 수정 요청, 반려
- 감사 기록
- 누가 언제 무엇을 승인했는지 기록
웹 규칙#
- 배치
- 제안과 원본을 나란히 두고, 근거 pane은 접을 수 있게 제공
- diff
- 삭제·추가·변경을 색뿐 아니라 라벨과 구조로 표시
- 적용
- 전체 적용보다 섹션별 적용을 우선
- 신뢰
- “확실함” 숫자만 단독 노출하지 않고, 근거 수·출처 품질·누락을 함께 표시
- 감사
- 승인 후 Toast만 띄우지 않고 기록 영역에 남김
모바일 규칙#
- 요약
- 첫 화면은 핵심 제안 1~3개와 영향 범위
- 표면
- 좁은 화면에서는 데스크탑 pane 테두리를 없애고 요약·근거·비교·결정을 순차 흐름으로 쌓음
- 근거
- 접힌 섹션 또는 BottomSheet로 제공. 긴 출처 목록을 첫 화면에 밀어 넣지 않음
- diff
- 한 줄 비교보다 전/후 카드 stack. 긴 diff는 상세로 이동
- 승인
- 승인 CTA는 단독으로 넓게, 수정 요청·반려는 같은 크기의 보조 버튼으로 배치. 위험 적용은 확인 sheet
- 수정 요청
- 자유 입력과 빠른 사유 칩을 함께 제공
상태#
- 생성 중
- Skeleton + “근거 수집 중” 상태
- 검토 대기
- 제안, 근거, 결정 CTA
- 부분 적용
- 적용된 항목과 남은 항목 분리
- 반려
- 사유 입력, 다음 행동
- 오류
- AI 제안 실패와 원본 작업 실패를 분리 표시
접근성#
- diff는 색 외에
추가됨,삭제됨,변경됨텍스트를 제공합니다. - AI 제안은 출처 없는 단정 문장으로 보이지 않게 근거 링크를 가까이 둡니다.
- 승인 CTA는 키보드 순서상 근거와 diff를 지나 도달하도록 배치합니다.
- 생성 중 텍스트를 토큰 단위로 계속 낭독하지 않고, 완료 후 결과를 상태로 알립니다.
- destructive 적용은 Modal/Sheet에서 대상과 결과를 다시 읽을 수 있게 합니다.
사용 컴포넌트#
Alert · Card · Tabs · Badge · Tag · Button · Textarea · FormMessage · Toast
검수 기준#
- 근거
- 모든 적용 가능한 제안은 출처 또는 제한 사항을 함께 표시
- 결정
- 승인·반려·수정 요청이 같은 위계로 이해됨
- diff
- 색을 빼도 변경 방향을 알 수 있음
- 모바일
- 첫 화면이 긴 출처 목록으로 시작하지 않음
- 기록
- 승인 결과가 화면에 남거나 감사 로그로 이어짐