文件共同創作工作流程
此技能提供一個結構化的工作流程，用於引導使用者進行協作文件創作。扮演主動引導者，帶領使用者經歷三個階段：收集脈絡、精煉與結構、以及讀者測試。
何時提供此工作流程
觸發條件：
- 使用者提及撰寫文件：「寫一份文件」、「草擬提案」、「建立規格」、「寫下來」
- 使用者提及特定文件類型：「PRD」、「設計文件」、「決策文件」、「RFC」
- 使用者似乎正要開始一項實質性的寫作任務
初步提議： 向使用者提供一個用於共同創作文件的結構化工作流程。解釋三個階段：
- 收集脈絡：使用者提供所有相關脈絡，同時 Claude 提出澄清問題
- 精煉與結構：透過腦力激盪和編輯，迭代地建立每個章節
- 讀者測試：使用全新的 Claude（無脈絡）測試文件，以在他人在閱讀前發現盲點
解釋這種方法有助於確保文件在他人閱讀時（包括當他們將文件貼到 Claude 中時）能夠正常運作。詢問他們是否想嘗試此工作流程，或偏好自由形式工作。
如果使用者拒絕，則自由形式工作。如果使用者接受，則進入階段 1。
階段 1：收集脈絡
目標： 縮小使用者所知與 Claude 所知之間的差距，以便後續提供智慧引導。
初始問題
首先向使用者詢問關於文件的後設脈絡：
- 這是什麼類型的文件？（例如，技術規格、決策文件、提案）
- 主要讀者是誰？
- 當有人閱讀此文件時，期望產生什麼影響？
- 是否有要遵循的模板或特定格式？
- 還有其他任何限制或脈絡需要知道嗎？
告知他們可以使用簡寫回答，或以最適合他們的方式傾倒資訊。
如果使用者提供模板或提及文件類型：
- 詢問他們是否有要分享的模板文件
- 如果他們提供共享文件的連結，請使用適當的整合來擷取它
- 如果他們提供檔案，請讀取它
如果使用者提及要編輯現有的共享文件：
- 使用適當的整合來讀取目前狀態
- 檢查沒有替代文字的圖片
- 如果有圖片沒有替代文字，請解釋當其他人使用 Claude 來理解文件時，Claude 將無法看到它們。詢問他們是否要生成替代文字。如果是，請要求他們將每張圖片貼到聊天中，以便生成描述性的替代文字。
資訊傾倒
一旦初始問題得到解答，鼓勵使用者傾倒他們擁有的所有脈絡。請求資訊，例如：
- 專案/問題的背景
- 相關的團隊討論或共享文件
- 為什麼不使用替代解決方案
- 組織脈絡（團隊動態、過去事件、政治）
- 時間壓力或限制
- 技術架構或依賴關係
- 利害關係人的擔憂
建議他們不要擔心組織資訊 - 只要全部傾倒出來即可。提供多種提供脈絡的方式：
- 意識流式資訊傾倒
- 指向要讀取的團隊頻道或討論串
- 連結到共享文件
如果整合可用（例如，Slack、Teams、Google Drive、SharePoint 或其他 MCP 伺服器），提及可以使用這些整合直接拉取脈絡。
如果未偵測到整合，且在 Claude.ai 或 Claude 應用程式中： 建議他們可以在 Claude 設定中啟用連接器，以便直接從訊息應用程式和文件儲存空間拉取脈絡。
告知他們，在他們完成初始傾倒後，將會提出澄清問題。
在收集脈絡期間：
-
如果使用者提及團隊頻道或共享文件：
- 如果整合可用：告知他們現在將讀取內容，然後使用適當的整合
- 如果整合不可用：解釋無法存取。建議他們在 Claude 設定中啟用連接器，或直接貼上相關內容。
-
如果使用者提及未知的實體/專案：
- 詢問是否應該搜尋已連接的工具以了解更多
- 等待使用者確認後再搜尋
-
當使用者提供脈絡時，追蹤正在學習的內容以及仍然不清楚的內容
提出澄清問題：
當使用者表示已完成初始傾倒（或在提供大量脈絡之後），提出澄清問題以確保理解：
根據脈絡中的缺口生成 5-10 個編號問題。
告知他們可以使用簡寫回答（例如，「1：是，2：見 #頻道，3：否，因為向後相容」），連結到更多文件，指向要閱讀的頻道，或繼續傾倒資訊。以對他們最有效率的方式進行。
結束條件： 當問題顯示出理解時，即已收集足夠的脈絡 - 當能夠在不需要解釋基礎知識的情況下詢問邊緣情況和取捨時。
過渡： 詢問他們是否還有任何想要在此階段提供的脈絡，或者是否可以繼續進行文件草稿。
如果使用者想添加更多內容，讓他們添加。準備就緒後，進入階段 2。
階段 2：精煉與結構
目標： 透過腦力激盪、策劃和迭代精煉，逐章節建立文件。
給使用者的說明： 解釋文件將逐章節建立。對於每個章節：
- 將會詢問關於要包含哪些內容的澄清問題
- 將會腦力激盪 5-20 個選項
- 使用者將指出要保留/刪除/合併哪些內容
- 該章節將被草擬
- 將透過手術式編輯進行精煉
從未知數最多的章節開始（通常是核心決策/提案），然後處理其餘部分。
章節排序：
如果文件結構清晰： 詢問他們想從哪個章節開始。
建議從未知數最多的章節開始。對於決策文件，通常是核心提案。對於規格，通常是技術方法。總結章節最好留到最後。
如果使用者不知道他們需要哪些章節： 根據文件類型和模板，建議 3-5 個適合該文件類型的章節。
詢問此結構是否可行，或者他們是否想要調整。
一旦結構達成一致：
建立包含所有章節的初始文件結構，並使用佔位文字。
如果可以存取工件：
使用 create_file 建立一個工件。這為 Claude 和使用者提供了一個可以從中工作的架構。
告知他們將建立包含所有章節佔位文字的初始結構。
建立包含所有章節標題和簡短佔位文字（例如「[待撰寫]」或「[此處為內容]」）的工件。
提供架構連結，並指出是時候填寫每個章節了。
如果無法存取工件：
在工作目錄中建立一個 markdown 檔案。適當命名（例如，decision-doc.md、technical-spec.md）。
告知他們將建立包含所有章節佔位文字的初始結構。
建立包含所有章節標題和佔位文字的檔案。
確認檔案名稱已建立，並指出是時候填寫每個章節了。
對於每個章節：
步驟 1：澄清問題
宣布將開始處理 [章節名稱] 章節。詢問 5-10 個關於應包含哪些內容的澄清問題：
根據脈絡和章節目的生成 5-10 個具體問題。
告知他們可以使用簡寫回答，或僅指出哪些內容很重要需要涵蓋。
步驟 2：腦力激盪
對於 [章節名稱] 章節，腦力激盪 [5-20] 個可能包含的項目，取決於章節的複雜度。尋找：
- 可能已被遺忘的共享脈絡
- 尚未提及的角度或考量
根據章節複雜度生成 5-20 個編號選項。最後，提供腦力激盪更多選項的選項，如果他們想要額外選項的話。
步驟 3：策劃
詢問哪些要點應該保留、刪除或合併。請求簡短的說明，以幫助為後續章節學習優先級。
提供範例：
- 「保留 1,4,7,9」
- 「刪除 3（與 1 重複）」
- 「刪除 6（讀者已經知道這個）」
- 「合併 11 和 12」
如果使用者提供自由形式回饋（例如，「看起來不錯」或「我大部分喜歡，但是...」）而不是編號選擇，則提取他們的偏好並繼續。解析他們想要保留/刪除/更改的內容並套用。
步驟 4：缺口檢查
根據他們所選的內容，詢問 [章節名稱] 章節是否有任何重要的遺漏。
步驟 5：草稿
使用 str_replace 將此章節的佔位文字替換為實際草擬的內容。
宣布現在將根據他們所選的內容草擬 [章節名稱] 章節。
如果使用工件： 草擬後，提供工件的連結。
要求他們閱讀它並指出要更改什麼。注意：具體說明有助於為後續章節學習。
如果使用檔案（無工件）： 草擬後，確認完成。
告知他們 [章節名稱] 章節已在 [檔案名稱] 中草擬完成。要求他們閱讀它並指出要更改什麼。注意：具體說明有助於為後續章節學習。
給使用者的關鍵說明（在草擬第一個章節時包含）： 提供一則備註：要求他們指出要更改什麼，而不是直接編輯文件。這有助於學習他們的風格以用於未來章節。例如：「刪除 X 要點 - Y 已涵蓋」或「讓第三段更簡潔」。
步驟 6：迭代精煉
當使用者提供回饋時：
- 使用
str_replace進行編輯（永遠不要重新印出整個文件） - 如果使用工件： 在每次編輯後提供工件連結
- 如果使用檔案： 僅確認編輯完成
- 如果使用者直接編輯文件並要求讀取：在心裡記下他們所做的更改，並在後續章節中考慮它們（這顯示了他們的偏好）
繼續迭代直到使用者對該章節感到滿意。
品質檢查
在連續 3 次沒有實質性更改的迭代之後，詢問是否可以刪除任何內容而不遺失重要資訊。
當章節完成時，確認 [章節名稱] 已完成。詢問是否準備好進行下一個章節。
對所有章節重複。
接近完成
當接近完成時（80% 以上的章節已完成），宣布打算重新閱讀整個文件並檢查：
- 跨章節的流程和一致性
- 冗餘或矛盾
- 任何感覺像是「敷衍」或通用填充物的內容
- 每個句子是否都有份量
閱讀整個文件並提供回饋。
當所有章節都已草擬並精煉時： 宣布所有章節都已草擬完成。表示打算再次審查完整文件。
審查整體連貫性、流程、完整性。
提供任何最終建議。
詢問是否準備好進行讀者測試，或者他們是否想要精煉任何其他內容。
階段 3：讀者測試
目標： 使用全新的 Claude（無脈絡污染）測試文件，以驗證它對讀者有效。
給使用者的說明： 解釋現在將進行測試，以查看文件是否真的對讀者有效。這可以捕捉盲點 - 對作者來說有意義但可能會讓其他人困惑的事情。
測試方法
如果可以存取子代理（例如，在 Claude Code 中）：
直接執行測試，無需使用者參與。
步驟 1：預測讀者問題
宣布打算預測讀者在嘗試發現此文件時可能會問的問題。
生成 5-10 個讀者可能會實際提出的問題。
步驟 2：使用子代理測試
宣布將使用全新的 Claude 實例（無此對話的脈絡）來測試這些問題。
對於每個問題，使用僅包含文件內容和該問題的子代理。
總結 Reader Claude 對每個問題回答正確/錯誤的內容。
步驟 3：執行額外檢查
宣布將執行額外檢查。
使用子代理檢查歧義、虛假假設、矛盾。
總結發現的任何問題。
步驟 4：報告與修復
如果發現問題：
報告 Reader Claude 在特定問題上遇到困難。
列出具體問題。
表示打算修復這些缺口。
回到有問題章節的精煉。
如果無法存取子代理（例如，claude.ai 網頁介面）：
使用者將需要手動進行測試。
步驟 1：預測讀者問題
詢問人們在嘗試發現此文件時可能會問什麼問題。他們會輸入什麼到 Claude.ai？
生成 5-10 個讀者可能會實際提出的問題。
步驟 2：設定測試
提供測試說明：
- 開啟一個全新的 Claude 對話：https://claude.ai
- 貼上或分享文件內容（如果使用已啟用連接器的共享文件平台，則提供連結）
- 向 Reader Claude 詢問生成的問題
對於每個問題，指示 Reader Claude 提供：
- 答案
- 是否有任何內容模糊不清或不清楚
- 文件假設讀者已經知道哪些知識/脈絡
檢查 Reader Claude 是否給出正確答案或誤解任何內容。
步驟 3：額外檢查
也詢問 Reader Claude：
- 「這份文件中哪些內容對讀者來說可能模糊不清或不清楚？」
- 「這份文件假設讀者已經具備哪些知識或脈絡？」
- 「是否有任何內部矛盾或前後不一致？」
步驟 4：根據結果迭代
詢問 Reader Claude 回答錯誤或難以處理的內容。表示打算修復那些缺口。
回到任何有問題章節的精煉。
結束條件（兩種方法皆適用）
當 Reader Claude 能夠一致正確地回答問題，並且不再提出新的缺口或歧義時，文件即準備就緒。
最終審查
當讀者測試通過時：
宣布文件已通過 Reader Claude 測試。在完成之前：
- 建議他們自己進行最後一次通讀 - 他們擁有此文件並對其品質負責
- 建議再次檢查任何事實、連結或技術細節
- 要求他們驗證文件是否達到了他們想要的影響