메인 콘텐츠로 건너뛰기
Document Review는 작성한 문서에 대해 구조적이고 실행 가능한 피드백을 제공합니다. Assistant에게 일반적인 질문을 하는 대신, Document Review는 문서 전체를 분석하여 구조, 명확성, 완결성 및 전반적인 품질에 대한 통찰을 제공합니다. 이 기능은 공유 전에 문제를 찾아내고 콘텐츠 품질을 개선하며 외부 관점을 얻는 데 도움을 줍니다 – 모두 Craft를 벗어나지 않고 수행할 수 있습니다.

Document Review의 기능

Document Review는 여러 차원에서 문서를 검토합니다: 구조 및 구성:
  • 논리적 흐름 및 전개
  • 제목(헤딩) 계층과 일관성
  • 섹션의 균형과 속도
  • 정보 아키텍처
명확성 및 가독성:
  • 문장 복잡도와 길이
  • 전문 용어 및 기술 용어 사용
  • 아이디어 간의 전환
  • 전반적인 가독성 점수
완결성:
  • 누락된 맥락 또는 배경
  • 설명의 공백
  • 답변되지 않은 질문들
  • 확장이 필요한 부분
품질 신호:
  • 톤의 일관성
  • 형식 문제
  • 중복 및 반복
  • 개선 기회
검토는 객관적이고 구체적이며 실행 가능해야 합니다 – 모호한 피드백이 아니라 구체적인 제안을 제공합니다.

Document Review 실행 방법

1
검토하려는 문서를 엽니다.
2
하단 모서리의 Assistant 아이콘을 클릭합니다.
3
New Chat를 선택합니다.
4
모드 선택기에서 Document Review를 선택합니다.
5
분석이 완료될 때까지 기다립니다 (보통 10-30초 소요됩니다).
Assistant가 문서 전체를 읽고 범주별로 정리된 구조화된 피드백을 제공합니다.
Document Review는 모든 모델과 함께 작동하지만, 특히 길거나 복잡한 문서의 경우 Max가 가장 철저하고 세밀한 피드백을 제공합니다. 빠른 확인이 필요할 때는 Fast가 깊이와 속도 사이의 균형이 좋습니다.

Document Review vs. 일반 Assistant 채팅

FeatureDocument ReviewGeneral Assistant Chat
Purpose구조화된 문서 피드백개방형 대화 및 작업
Scope문서 전체 분석특정 질문에 대한 답변
Output format피드백 카테고리별로 정리됨대화형 응답
Analysis depth포괄적이고 다차원적 분석특정 질문에 집중
Best for품질 점검, 게시 전 검토빠른 편집, 요약, 콘텐츠 질의
Follow-up prompts확인 질문을 할 수 있음연속적인 대화
Credit usage더 높음 (문서 전체 분석)질문 복잡도에 따라 다름
문서 전체에 대해 포괄적인 피드백을 원할 때는 Document Review를 사용하세요. 특정 질문이나 작업이 있을 때는 일반 채팅을 사용하세요.

Document Review를 사용하면 좋은 경우

Document Review는 다음 시나리오에서 특히 유용합니다:

외부 공유 전

발표자료, 제안서 또는 고객 전달 문서를 공유하기 전에 구조적 문제, 불명확한 섹션 또는 누락된 맥락을 찾아내세요.

품질 보증

중요한 문서화, 팀 위키 또는 지식 기반 아티클에 대해 주기적으로 검토를 실행하여 시간에 따른 품질과 일관성을 유지하세요.

콘텐츠 개선

블로그 포스트, 보고서 또는 장문 글에 대해 실행 가능한 제안을 받으세요. Assistant는 확장, 단순화 또는 재구성이 필요한 부분을 식별할 수 있습니다.

협업 준비

팀원과 공유하기 전에 문서가 명확하고 완결되었는지 확인하세요. 이는 불필요한 반복을 줄이고 협업 효율을 높입니다.

학습 및 역량 개발

검토를 통해 글쓰기 패턴 – 반복되는 명확성 문제, 구조적 성향 또는 일관되게 개선이 필요한 영역 – 을 이해할 수 있습니다.
Document Review를 여러 번 실행할 수 있습니다. 피드백을 반영해 변경한 뒤 다시 검토하여 문제가 해결되었는지 확인하세요. 이러한 반복적 접근은 어떤 방식이 효과적인지 배우고 콘텐츠를 점진적으로 다듬는 데 도움이 됩니다.

피드백 이해하기

Document Review의 피드백은 명확한 카테고리로 정리되어 제공됩니다. 다음은 이를 해석하고 행동으로 옮기는 방법입니다:

구조 관련 피드백

의미: 콘텐츠의 흐름, 섹션 균형, 정보 구조의 적절성을 알려줍니다. 예시 피드백:
  • “도입부가 문서 나머지에 비해 너무 깁니다”
  • “섹션 3가 섹션 2에서의 전환이 명확하지 않습니다”
  • “헤딩 계층이 H2에서 H4로 건너뛰고 있습니다”
활용 방법: 섹션 재구성, 속도 조정, 헤딩 레벨 수정 또는 전환 문구 추가 등을 고려하세요.

명확성 관련 피드백

의미: 글이 이해하기 쉬운지, 문장이 너무 복잡한지, 독자가 혼란스러울 가능성이 있는지를 알려줍니다. 예시 피드백:
  • “이 단락은 수동태를 과도하게 사용하여 이해하기 어렵습니다”
  • “첫 섹션의 전문 용어가 비전문가 독자를 혼란스럽게 할 수 있습니다”
  • “문장 평균 길이가 35단어입니다 – 문장을 더 짧게 나누는 것을 고려하세요”
활용 방법: 문장 단순화, 전문 용어를 쉬운 표현으로 대체하거나 처음 등장 시 정의를 추가하세요.

완결성 관련 피드백

의미: 맥락이 빠져 있거나 답이 없는 질문, 더 많은 설명이 필요한 부분을 지적합니다. 예시 피드백:
  • “문서에서 ‘새 프로세스’를 언급하지만 정의가 없습니다”
  • “2단계와 3단계는 서론에서 다루지 않은 사전 지식을 전제로 합니다”
  • “결론이나 다음 단계가 제공되지 않았습니다”
활용 방법: 누락된 배경 정보를 추가하거나 얇은 섹션을 확장하고 요약 및 결론을 포함하세요.

품질 관련 피드백

의미: 톤 일관성, 형식 문제 및 다듬을 기회를 알려줍니다. 예시 피드백:
  • “섹션 간에 톤이 격식 있는 표현에서 캐주얼한 표현으로 바뀝니다”
  • “글머리표 형식이 일관되지 않습니다 (일부는 마침표로 끝나고 일부는 그렇지 않음)”
  • “동일한 개념이 두 번 설명되어 있습니다 – 통합을 고려하세요”
활용 방법: 형식을 표준화하고, 톤을 유지하며, 중복을 제거하세요.

크레딧 사용량

Document Review는 문서 길이와 복잡성에 따라 AI 크레딧을 소모합니다:
Document LengthApprox. Credit Cost (Fast)Approx. Credit Cost (Max)
Short (< 500 words)~0.5 credits~1-2 credits
Medium (500-2000 words)~1-2 credits~3-5 credits
Long (2000-5000 words)~2-4 credits~6-10 credits
Very long (5000+ words)~5+ credits~12+ credits
위 수치는 일반적인 문서를 기준으로 한 추정치입니다. 실제 사용량은 문서 구조, 형식의 복잡성 및 선택한 모델에 따라 달라집니다. Assistant 메뉴에서 크레딧 잔액을 확인하세요.
Document Review는 문서 전체를 한 번에 분석하므로 단일 질문보다 더 많은 크레딧을 사용할 수 있습니다. 그러나 포괄적인 피드백은 여러 번의 개별 질의보다 시간 절약과 품질 개선에 더 효율적일 수 있습니다.

더 나은 검토를 위한 팁

1. 먼저 문서를 준비하세요 검토를 실행하기 전에 문서가 비교적 완성된 상태인지 확인하세요. Assistant는 초안보다 완성된 초안에서 더 나은 피드백을 제공합니다. 2. 대상 독자를 명시하세요 후속 프롬프트에서 문서의 대상 독자를 알려주세요:
  • “이 문서는 제품에 익숙한 기술팀을 위한 것입니다”
  • “대상은 비전문가 이해관계자입니다”
  • “Craft를 전혀 사용해본 적이 없는 신규 사용자용입니다”
이러한 맥락은 Assistant가 피드백을 특정 요구에 맞추는 데 도움이 됩니다. 3. 우선순위화된 피드백을 요청하세요 검토에서 많은 문제가 식별되면 Assistant에게 우선순위를 매겨 달라고 요청하세요:
  • “먼저 고쳐야 할 3가지 문제는 무엇인가요?”
  • “가장 치명적인 구조적 문제는 무엇인가요?”
  • “명확성 문제에만 집중해 주세요”
4. 특정 유형의 피드백을 요청하세요 검토를 유도하여 집중된 분석을 받을 수 있습니다:
  • “톤 일관성만 검토해 주세요”
  • “완결성과 누락된 맥락만 확인해 주세요”
  • “초보자 대상에 적합한 구조인지 여부에 집중해 주세요”
5. 적절한 모델을 사용하세요
  • On-device: Document Review에는 권장되지 않습니다 (컨텍스트 제한)
  • Core: 짧은 문서에 대한 빠른 구조 점검
  • Fast: 대부분의 검토(500-2000 단어)에 적합한 균형
  • Max: 길고 복잡한 문서 또는 가장 철저한 피드백이 필요할 때 최적

예시: 블로그 게시물 게시 전

Sarah는 Craft에서 컬렉션을 사용하는 방법에 관한 블로그 게시물을 작성했습니다. 게시 전에 내용이 명확하고 완결되었는지 확인하고자 합니다.
1
Sarah는 Craft에서 초안 블로그 게시물을 엽니다.
2
그녀는 Assistant 아이콘을 클릭하고 Document Review를 선택합니다.
3
Assistant가 문서를 분석하고 다음과 같은 피드백을 제공합니다:
  • Structure: “도입부는 강하지만 섹션 2가 섹션 3 및 4를 합친 것보다 두 배 길게 작성되어 있습니다. 섹션 2를 둘로 나누는 것을 고려하세요.”
  • Clarity: “여러 기술 용어(relations, properties, views)가 정의되기 전에 사용되었습니다. 용어집을 추가하거나 처음 등장할 때 정의하세요.”
  • Completeness: “게시물은 컬렉션이 무엇인지 설명하지만 컬렉션과 폴더 또는 태그를 언제 사용하는지에 대해서는 다루지 않습니다.”
  • Quality: “톤은 일관됩니다. 끝부분의 중복 섹션이 도입부를 반복합니다 – 삭제를 고려하세요.”
4
Sarah는 피드백을 바탕으로 조정합니다: 섹션 2를 분할하고 정의를 추가하며 “컬렉션을 언제 사용해야 하는가” 섹션을 포함하고 중복을 제거합니다.
5
그녀는 Document Review를 다시 실행합니다. Assistant는 문제가 해결되었음을 확인합니다.
6
Sarah는 콘텐츠가 명확하고 완결되었음을 확신하며 게시합니다.

한계

Document Review는 읽기 전용입니다. Assistant는 피드백을 제공하지만 문서를 자동으로 편집하지는 않습니다. 어떤 제안을 수용할지와 어떻게 변경할지는 사용자가 결정합니다. 매우 짧은 문서(200단어 미만)의 경우 Document Review가 큰 도움이 되지 않을 수 있으며 – 빠른 작업에는 일반 Assistant 채팅이 더 적합할 수 있습니다.

관련 문서