Document Review 可以做什麼
Document Review 會從多個面向檢視你的文件： 結構與組織：- 邏輯流程與段落銜接
- 標題層級與一致性
- 章節的平衡與節奏
- 資訊架構
- 句子複雜度與長度
- 專業術語與技術用語的使用
- 想法之間的轉接
- 整體可讀性評分
- 缺少的背景或情境
- 說明中的斷層
- 未解答的問題
- 需要擴充的部分
- 語氣的一致性
- 格式化問題
- 冗贅與重複
- 改進的機會
如何啟動 Document Review
Assistant 會閱讀整份文件，並以分類方式提供結構化回饋。Document Review 可搭配所有模型使用，但 Max 在處理較長或較複雜的文件時能提供最完整且細緻的回饋。若要快速檢查，Fast 在深度與速度之間有良好平衡。
Document Review 與一般 Assistant 聊天的差異
| Feature | Document Review | General Assistant Chat |
|---|---|---|
| Purpose | Structured document feedback | Open-ended conversation and tasks |
| Scope | Entire document analysis | Answers specific questions |
| Output format | Organized by feedback categories | Conversational responses |
| Analysis depth | Comprehensive, multi-dimensional | Focused on your specific question |
| Best for | Quality checks, pre-publish reviews | Quick edits, summaries, content queries |
| Follow-up prompts | Can ask clarifying questions | Continuous conversation |
| Credit usage | Higher (analyzes full document) | Varies by query complexity |
什麼時候應該使用 Document Review
Document Review 在下列情境特別有價值：在對外分享之前
在寄出簡報、提案或客戶文件前檢查結構問題、不清楚的段落或缺少的背景資訊。品質保證
定期對重要文件、團隊知識庫或說明文件執行檢閱，以維持長期的一致性與高品質。內容改進
針對部落格文章、報告或長文獲得可執行的建議。Assistant 可指出需要擴充、簡化或重組的區域。協作準備
在分享給同事前，確認你的文件清晰、完整且組織良好，這能減少來回修正並提升協作效率。學習與能力提升
利用檢閱了解寫作模式 – 重複出現的清晰度問題、結構傾向或你經常需要改進的地方。你可以多次執行 Document Review。根據回饋修改後再檢閱，查看問題是否已解決。這種反覆作法能幫助你學習有效的寫作方式並逐步精進內容。
解讀回饋的方法
Document Review 的回饋會以明確類別來組織。以下說明如何解讀並採取行動：結構回饋
告訴你的內容： 內容的流暢度、章節是否平衡，以及資訊架構是否合理。 範例回饋：- 「引言相較於文件其他部分過長」
- 「第 3 節缺乏從第 2 節的明確銜接」
- 「標題層級從 H2 跳到 H4」
清晰度回饋
告訴你的內容： 是否易於理解、句子是否過於複雜，以及讀者可能在哪裡感到困惑。 範例回饋：- 「這段大量使用被動語態，使得閱讀較為吃力」
- 「第一部分出現技術術語，可能讓非專業讀者感到困惑」
- 「句子平均長度為 35 個字 – 建議斷句以提升可讀性」
完整性回饋
告訴你的內容： 內容的缺口 – 缺少背景、未回答的問題或需要更多細節的部分。 範例回饋：- 「文件提到『新的流程』卻未定義它」
- 「步驟 2 與 3 假設了先前知識，但導言未涵蓋」
- 「未提供結論或後續步驟」
品質回饋
告訴你的內容： 語氣一致性、格式化問題，以及可以潤飾的地方。 範例回饋：- 「不同章節之間語氣從正式轉為口語」
- 「項目符號格式不一致（有些以句號結尾，有些沒有）」
- 「此概念重複出現 – 建議合併」
點數使用說明
Document Review 會根據文件長度與複雜度消耗 AI 點數：| Document Length | Approx. 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 選單中查看你的點數餘額。
提升檢閱品質的建議
1. 先把文件準備好 在執行檢閱前，確保文件已屬於相對完整的草稿。Assistant 對於完成度較高的稿件能提供更精準的建議，而非草擬大綱。 2. 說明你的讀者 在後續提示中，告訴 Assistant 這份文件的受眾：- 「這份文件是針對熟悉產品的技術團隊」
- 「受眾為非技術的利害關係人」
- 「寫給從未使用過 Craft 的新使用者」
- 「我應先修正哪三個問題？」
- 「最重要的結構性問題是什麼？」
- 「僅針對清晰度問題進行檢查」
- 「檢查語氣一致性」
- 「僅檢查完整性與缺失的背景」
- 「著重判斷結構是否適合初學者」
- On-device: 不建議用於 Document Review（上下文有限）
- Core: 適合對短文件做快速的結構檢查
- Fast: 對大多數檢閱（500 - 2000 字）而言是平衡的選擇
- Max: 適用於長篇、複雜的文件，或需要最詳盡建議時
範例：在發布部落格文章前
Sarah 撰寫一篇關於在 Craft 使用 集合 (Collections) 的部落格文章。在發布前，她想確認內容是否清晰且完整。Assistant 分析文件並提供回饋：
- Structure: “引言表現良好，但第 2 節的篇幅是第 3 與第 4 節總和的兩倍。考慮將其拆成兩部分。”
- Clarity: “多個技術術語（relations、properties、views）在未定義前就被使用。請在首次出現時加入定義或附上術語表。”
- Completeness: “文章說明了 什麼是 集合，但沒有說明何時該使用集合而非資料夾或標籤。”
- Quality: “語氣一致。結尾有一段重複前言 – 建議移除。”