문서 검토는 글쓰기에 대한 구조적이고 실용적인 피드백을 제공합니다. Assistant에게 일반적인 질문을 하는 대신, 문서 검토는 전체 문서를 분석하여 구조, 명확성, 완성도, 전반적인 품질에 대한 인사이트를 제공합니다. 공유하기 전에 문제를 발견하고, 콘텐츠 품질을 향상시키고, 작업에 대한 외부 시각을 얻는 데 도움이 됩니다. 모두 Craft를 벗어나지 않고도 가능합니다.Documentation Index
Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
문서 검토가 하는 일
문서 검토는 여러 차원에서 문서를 분석합니다. 구조 및 구성:- 논리적 흐름과 전개
- 제목 계층 구조 및 일관성
- 섹션 균형 및 분배
- 정보 아키텍처
- 문장의 복잡도와 길이
- 전문 용어 및 기술 언어 사용
- 아이디어 간 전환
- 전체적인 가독성 점수
- 누락된 컨텍스트 또는 배경
- 설명의 빈틈
- 답변되지 않은 질문
- 확장이 필요한 영역
- 어조의 일관성
- 서식 문제
- 중복 및 반복
- 개선 기회
문서 검토 실행 방법
Assistant가 전체 문서를 읽고 카테고리별로 구조화된 피드백을 제공합니다.
문서 검토는 모든 모델에서 작동하지만, Max는 특히 길거나 복잡한 문서에 대해 가장 철저하고 세밀한 피드백을 제공합니다. 빠른 확인을 위해서는 Fast가 깊이와 속도 사이에서 좋은 균형을 제공합니다.
문서 검토 vs. 일반 Assistant 채팅
| 기능 | 문서 검토 | 일반 Assistant 채팅 |
|---|---|---|
| 목적 | 구조화된 문서 피드백 | 자유로운 대화 및 작업 |
| 범위 | 전체 문서 분석 | 특정 질문에 답변 |
| 출력 형식 | 피드백 카테고리별 구성 | 대화식 응답 |
| 분석 깊이 | 종합적, 다차원적 | 특정 질문에 집중 |
| 적합한 경우 | 품질 확인, 게시 전 검토 | 빠른 편집, 요약, 콘텐츠 질의 |
| 후속 프롬프트 | 명확화 질문 가능 | 지속적인 대화 |
| 사용량 | 높음 (전체 문서 분석) | 질문 복잡도에 따라 다름 |
문서 검토를 사용할 때
문서 검토는 다음 상황에서 가장 효과적입니다.외부 공유 전
발표 자료, 제안서, 고객용 문서를 공유하기 전에 구조적 문제, 불명확한 섹션, 누락된 컨텍스트를 확인하세요.품질 보증
중요한 문서, 팀 위키, 지식 베이스 문서를 주기적으로 검토하여 높은 품질과 일관성을 유지하세요.콘텐츠 개선
블로그 게시물, 보고서, 장문의 글에 대한 실용적인 제안을 받으세요. Assistant는 확장, 단순화, 재구성이 필요한 영역을 파악할 수 있습니다.협업 준비
팀원과 공유하기 전에 문서가 명확하고 완성도 있으며 잘 구성되어 있는지 확인하세요. 이는 불필요한 소통을 줄이고 협업 효율성을 높입니다.학습 및 역량 개발
검토를 통해 글쓰기 패턴을 파악하세요. 반복되는 명확성 문제, 구조적 경향, 또는 지속적으로 개선이 필요한 영역을 발견할 수 있습니다.문서 검토를 여러 번 실행할 수 있습니다. 피드백을 바탕으로 수정한 후 다시 검토하여 문제가 해결되었는지 확인하세요. 이 반복적인 접근 방식은 효과적인 방법을 배우고 콘텐츠를 점진적으로 개선하는 데 도움이 됩니다.
피드백 이해하기
문서 검토 피드백은 명확한 카테고리로 구성됩니다. 해석하고 활용하는 방법은 다음과 같습니다.구조 피드백
알려주는 내용: 콘텐츠가 얼마나 잘 흐르는지, 섹션이 균형 잡혀 있는지, 정보 아키텍처가 합리적인지. 피드백 예시:- “서론이 나머지 문서에 비해 너무 깁니다”
- “3섹션에 2섹션에서의 명확한 전환이 없습니다”
- “제목 계층이 H2에서 H4로 건너뜁니다”
명확성 피드백
알려주는 내용: 글쓰기가 이해하기 쉬운지, 문장이 너무 복잡한지, 독자가 혼란을 느낄 수 있는 부분. 피드백 예시:- “이 단락은 수동태를 많이 사용하여 이해하기 어렵습니다”
- “첫 번째 섹션의 전문 용어가 비전문 독자를 혼란스럽게 할 수 있습니다”
- “문장 길이가 평균 35단어입니다. 더 짧은 문장으로 나누는 것을 고려해 보세요”
완성도 피드백
알려주는 내용: 콘텐츠의 빈틈, 누락된 컨텍스트, 답변되지 않은 질문, 더 자세한 설명이 필요한 영역. 피드백 예시:- “문서에서 ‘새로운 프로세스’를 언급하지만 정의하지 않았습니다”
- “2단계와 3단계는 서론에서 다루지 않은 사전 지식을 가정합니다”
- “결론 또는 다음 단계가 없습니다”
품질 피드백
알려주는 내용: 어조의 일관성, 서식 문제, 콘텐츠를 다듬을 기회. 피드백 예시:- “섹션 간에 어조가 격식체에서 비격식체로 변합니다”
- “불릿 포인트의 서식이 일관되지 않습니다 (일부는 마침표로 끝나고 일부는 그렇지 않음)”
- “이 개념이 두 번 설명되었습니다. 통합하는 것을 고려해 보세요”
사용량
문서 검토는 전체 문서를 한 번에 분석하기 때문에 단순한 질문보다 더 많은 AI 할당량을 사용합니다. 더 길고 복잡한 문서는 더 많은 할당량을 사용합니다. 더 빠르고 가벼운 검토에는 Fast를 사용하세요.실제 사용량은 문서 길이, 구조, 서식 복잡도, 선택한 모델에 따라 달라집니다. Assistant 메뉴의 사용량 및 제한에서 사용량을 확인하세요.
더 나은 검토를 위한 팁
1. 먼저 문서를 준비하세요 검토를 실행하기 전에 문서가 어느 정도 완성된 상태인지 확인하세요. Assistant는 초안보다 완성된 문서에 대해 더 나은 피드백을 제공합니다. 2. 독자층을 지정하세요 후속 프롬프트에서 문서의 대상 독자를 알려주세요.- “이것은 제품에 익숙한 기술 팀을 위한 것입니다”
- “독자는 비기술적인 이해관계자입니다”
- “Craft를 한 번도 사용해 본 적 없는 신규 사용자를 위해 작성되었습니다”
- “먼저 수정해야 할 3가지 문제는 무엇인가요?”
- “가장 중요한 구조적 문제는 무엇인가요?”
- “명확성 문제에만 집중해 주세요”
- “어조의 일관성을 검토해 주세요”
- “완성도와 누락된 컨텍스트만 확인해 주세요”
- “구조가 초보자 독자에게 적합한지에 집중해 주세요”
- On-device: 문서 검토에 권장하지 않음 (컨텍스트 제한)
- Core: 짧은 문서의 빠른 구조 확인
- Fast: 대부분의 검토에 적합한 균형 (500~2000 단어)
- Max: 길고 복잡한 문서 또는 가장 철저한 피드백이 필요할 때
예시: 블로그 게시물 발행 전
Sarah는 Craft에서 컬렉션 사용에 관한 블로그 게시물을 작성합니다. 발행 전에 내용이 명확하고 완성도 있는지 확인하고 싶습니다.Assistant가 문서를 분석하고 피드백을 제공합니다.
- 구조: “서론은 강하지만, 2섹션이 3섹션과 4섹션을 합친 것보다 두 배 길니다. 두 부분으로 나누는 것을 고려해 보세요.”
- 명확성: “여러 기술 용어(관계, 속성, 뷰)가 정의되기 전에 사용되었습니다. 용어집을 추가하거나 처음 사용할 때 정의하세요.”
- 완성도: “게시물은 컬렉션이 무엇인지 설명하지만, 폴더나 태그 대신 언제 사용해야 하는지는 다루지 않습니다.”
- 품질: “어조는 일관됩니다. 마지막에 서론을 반복하는 중복 섹션이 하나 있습니다. 제거하는 것을 고려해 보세요.”
제한 사항
문서 검토는 피드백을 제공하지만 직접 변경 사항을 적용하지는 않습니다. 제안 사항을 실행하려면 Fast 또는 Max 모델과 함께 Execute 모드로 전환하고 Assistant에게 권장 변경 사항을 적용하도록 요청하세요. Craft Assistant로 편집하기를 참고하세요. 매우 짧은 문서(200단어 미만)의 경우 문서 검토가 큰 도움이 되지 않을 수 있습니다. 빠른 작업에는 일반 Assistant 채팅이 더 적합한 경우가 많습니다.관련 문서
Craft Assistant 사용하기
Assistant와 작업하고 대화를 시작하는 방법 알아보기
AI 모델 선택하기
문서 검토 및 기타 작업에 맞는 모델 선택
Craft Assistant로 편집하기
Execute 모드에서 검토 제안 사항 직접 적용하기
커스텀 프롬프트
일관된 피드백을 위한 재사용 가능한 검토 지침 만들기
사용량 및 제한
문서 검토 및 기타 기능의 AI 사용량 이해하기