文件審閱功能可為您的寫作提供有結構、可行動的意見回饋。與其向 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 在深度與速度之間取得良好平衡。
文件審閱與一般 Assistant 對話的比較
| 功能 | 文件審閱 | 一般 Assistant 對話 |
|---|---|---|
| 用途 | 有結構的文件回饋 | 開放式對話與任務 |
| 範圍 | 整份文件分析 | 回答特定問題 |
| 輸出格式 | 按回饋類別整理 | 對話式回應 |
| 分析深度 | 全面、多維度 | 聚焦於您的特定問題 |
| 最適合 | 品質檢查、發布前審閱 | 快速編輯、摘要、內容查詢 |
| 後續提問 | 可提出進一步問題 | 持續對話 |
| 用量 | 較高(分析整份文件) | 依查詢複雜度而異 |
適合使用文件審閱的時機
文件審閱在以下情況最具價值:對外分享前
審閱簡報、提案或面向客戶的文件,在送出前找出結構問題、不清楚的段落或缺少的背景。品質保證
定期審閱重要文件、團隊知識庫或說明文章,長期維持高品質與一致性。內容優化
為部落格文章、報告或長篇寫作獲取可行建議。Assistant 可找出需要擴充、簡化或重構的部分。協作前準備
在與團隊成員分享前,確認文件清晰、完整、組織良好,減少來回溝通並提升協作效率。學習與技能提升
利用審閱了解寫作中的規律——反覆出現的清晰度問題、結構傾向,或需要持續改進的地方。您可以多次執行文件審閱。根據回饋進行修改後再次審閱,確認問題是否已解決。這種反覆的方式有助於學習什麼有效,並逐步精進內容。
理解回饋內容
文件審閱的回饋依明確類別整理。以下說明如何解讀並採取行動:結構回饋
告訴您什麼: 內容的流暢程度、各節是否平衡,以及資訊架構是否合理。 回饋範例:- 「前言相對於文件其他部分過長」
- 「第 3 節缺乏從第 2 節過渡的清楚銜接」
- 「標題層級從 H2 直接跳至 H4」
清晰度回饋
告訴您什麼: 寫作是否容易理解、句子是否過於複雜,以及讀者可能感到困惑的地方。 回饋範例:- 「這個段落大量使用被動語態,使內容較難跟讀」
- 「第一節的專業術語可能讓非專業讀者感到困惑」
- 「句子平均長度為 35 個字——考慮拆分為較短的句子」
完整性回饋
告訴您什麼: 內容的缺口——缺少的背景、未解答的問題,或需要更多細節的部分。 回饋範例:- 「文件提到「新流程」但從未加以定義」
- 「步驟 2 和 3 預設了前言中未涵蓋的先備知識」
- 「未提供結論或後續步驟」
品質回饋
告訴您什麼: 語氣一致性、格式問題,以及內容潤色的機會。 回饋範例:- 「各節之間語氣從正式切換至隨性」
- 「項目符號格式不一致(部分有句號,部分沒有)」
- 「這個概念被解釋了兩次——考慮合併」
用量
文件審閱比一般問題使用更多 AI 配額,因為它會一次性分析整份文件。文件越長越複雜,用量越多。若需較快速的輕量審閱,請使用 Fast。實際用量取決於文件長度、結構、格式複雜度及所選模型。您可在 Assistant 選單的用量與限制中查看用量。
提升審閱效果的技巧
1. 先完善您的文件 請確認文件有一定的完整度再執行審閱。Assistant 對完成草稿的回饋優於對粗略大綱的回饋。 2. 說明您的目標讀者 在後續提問中,告訴 Assistant 這份文件的對象是誰:- 「這份文件的讀者是熟悉產品的技術團隊」
- 「目標受眾是非技術的利害關係人」
- 「為從未使用過 Craft 的新用戶撰寫」
- 「我應該先修改哪 3 個問題?」
- 「最關鍵的結構問題是什麼?」
- 「只聚焦於清晰度問題」
- 「審閱這份文件的語氣一致性」
- 「只檢查完整性和缺少的背景」
- 「聚焦於結構是否適合初學者閱讀」
- 本地端: 不建議用於文件審閱(情境長度有限)
- Core: 對短文件進行快速結構檢查
- Fast: 大多數審閱的良好選擇(500-2000 字)
- Max: 最適合長篇、複雜文件,或需要最深入回饋時
範例:發布部落格文章前
Sarah 撰寫了一篇關於在 Craft 中使用集合的部落格文章。在發布前,她想確認內容清晰且完整。Assistant 分析文件後提供以下回饋:
- 結構:「前言有力,但第 2 節的篇幅是第 3 和第 4 節加起來的兩倍,考慮拆分為兩個部分。」
- 清晰度:「多個技術術語(關聯、屬性、視圖)在定義前就已使用,建議加入詞彙表或在首次出現時加以定義。」
- 完整性:「文章解釋了集合是什麼,但沒有說明何時使用集合相對於資料夾或標籤。」
- 品質:「語氣一致。結尾有一個重複的段落複述了前言——考慮刪除。」
功能限制
文件審閱提供回饋,但不會直接套用變更。若要根據建議採取行動,請切換至 Execute 模式並搭配 Fast 或 Max 模型,要求 Assistant 實作建議的修改。請參閱使用 Craft Assistant 編輯文件。 對於非常短的文件(不足 200 字),文件審閱可能價值有限——一般 Assistant 對話通常更適合快速任務。相關文章
使用 Craft Assistant
學習如何使用 Assistant 並開始對話
選擇 AI 模型
為文件審閱及其他任務選擇合適的模型
使用 Craft Assistant 編輯文件
在 Execute 模式下直接套用審閱建議
自訂提示詞
建立可重複使用的審閱指令以獲得一致回饋
用量與限制
瞭解文件審閱及其他功能的 AI 用量