Material to Deliverable
將 00_input/ 中的真實資料整理成可檢查、可追溯、可交付的文字文件。
啟動條件
僅在同時滿足以下條件時執行。
- 用戶提供或指定了本地專案目錄。
00_input/中至少有一份真實材料。- 用戶希望得到彙報、方案、復盤、調研或課程展示之一。
目錄不明確時,只問專案目錄。交付類型不明確時,只問交付類型。沒有真實材料時停止,不生成範例或替代材料。
每次都要讀取
開始處理前完整讀取:
確認交付類型以後,再讀取 交付類型規則 中對應的一節。
工作流程
1. 確認專案與初始化
專案尚未初始化時,從本 Skill 的安裝目錄呼叫腳本,並傳入明確的專案路徑:
python3 <skill-directory>/scripts/init_project.py /absolute/path/to/project
不要假設用戶專案當前目錄中存在 scripts/。先根據本文件位置解析 <skill-directory>,再執行腳本。
如果 01_working/ 已存在,讀取已有狀態並繼續,不重新初始化,不覆蓋文件。
2. 檢查輸入與敏感資訊
列出 00_input/ 中全部文件,記錄無法讀取或來源不明的文件。不要修改、移動或重新命名原始材料。
先做敏感資訊檢查。發現姓名、個人聯絡方式、帳號、客戶資料、合約、財務、健康、教育記錄、憑證、內部路徑或其他可能受限的資訊時:
- 只在
02_material-index.md記錄風險類型與檔案位置,不複製敏感值。 - 立即暫停。
- 請用戶確認其有權處理這些材料,或請用戶提供脫敏副本。
未經用戶確認,不繼續提綱、寫作和交付。
3. 釐清任務
每次只問一個會改變成品的問題,最多七個。優先確認接收者、使用場景、希望促成的決定、截止時間、交付類型、必須保留和禁止出現的內容。
用戶回答「不知道」時,寫入待確認事項,不替用戶補答案。將結果寫入 01_task-brief.md,展示摘要,等待用戶確認。
4. 建立材料索引與缺口
逐份材料填寫 02_material-index.md,分清:
- 來源能夠直接支援的事實
- 當事人或機構自述
- 訪談、回饋或局部觀察
- 用戶本人判斷
- 待確認資訊
將衝突、缺失、無法讀取、需要脫敏和證據不足的內容寫入 03_gaps-and-conflicts.md。少量材料不能擴大為普遍結論。
阻斷性缺口仍存在時繼續提問或停止,不生成主成品。
5. 建立帶來源提綱
根據交付類型建立 04_source-backed-outline.md。每個部分必須寫清要回答的問題、使用的材料、允許得出的結論、用戶判斷、待確認項和驗收方式。
展示提綱摘要與來源覆蓋情況,等待用戶確認。未確認前不寫主成品。
6. 生成成品與來源索引
根據確認後的提綱生成:
05_main-deliverable.md06_one-page-summary.md07_source-index.md
每個關鍵事實都要在來源索引中對應到具體檔案和位置。不得補寫材料中沒有的數字、人物、案例、引語或結果。個人判斷必須與來源事實分開。
7. 回到原始材料審核
重新讀取 00_input/,不要只根據剛生成的成品自我檢查。將事實、範圍、邏輯、隱私、任務一致性和表達問題寫入 08_audit-report.md。
只修改能夠由現有材料明確修復的問題。需要用戶判斷的內容保持待確認。
8. 整理交付包
只有審核中沒有阻斷問題時,才把通過審核的內容寫入:
02_delivery/
main-deliverable.md
one-page-summary.md
source-index.md
readme.md
02_delivery/ 不得包含原始材料、提示詞、聊天記錄、內部草稿或敏感值。最後仍從本 Skill 的安裝目錄執行:
python3 <skill-directory>/scripts/validate_project.py /absolute/path/to/project --stage delivery
驗證腳本通過後,仍要提醒用戶做最終人工放行。腳本只檢查檔案結構與明顯殘留,不能證明事實正確。
停止條件
遇到以下任一情況就停止,並說明缺少什麼。
00_input/為空或材料無法讀取。- 用戶未確認敏感材料可以繼續處理。
- 接收者、交付類型或核心目標仍不明確。
- 當前材料無法支援主要結論。
- 用戶尚未確認任務單或提綱。
不要用虛構材料、聯網搜尋或常識推斷繞過停止條件,除非用戶另行明確授權新的資料來源。
輸出語言
預設跟隨用戶當前使用的語言。檔案名稱保持英文,便於跨環境使用;檔案內容使用用戶語言。