Community研究與資料分析github.com

Lucian1u/material-to-deliverable

將散亂的真實資料,沉澱成可複用、可追溯的文稿、摘要與來源索引。

material-to-deliverable 是什麼?

此技能專為需要將原始資料(如報告、訪談、筆記)轉化為結構化交付物的開發者與知識工作者設計。它能自動從`00_input/`目錄讀取真實材料,引導使用者確認交付類型(如方案、摘要),並執行嚴格的八步驟工作流程:初始化專案、檢查敏感資訊、釐清任務、建立材料索引與缺口、產出來源背書的提綱、生成成品與來源索引、審核原始材料,最後輸出`02_delivery/`目錄中的乾淨交付包。支援CLI環境(如Claude Code、Codex),透過`init_project.py`與`validate_project.py`腳本管理。其最大價值在於強制事實溯源、分離個人判斷、避免生成虛構內容,確保輸出的知識資產可檢查、可追蹤且可直接交付。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Lucian1u/material-to-deliverable

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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/ 中全部文件,記錄無法讀取或來源不明的文件。不要修改、移動或重新命名原始材料。

先做敏感資訊檢查。發現姓名、個人聯絡方式、帳號、客戶資料、合約、財務、健康、教育記錄、憑證、內部路徑或其他可能受限的資訊時:

  1. 只在 02_material-index.md 記錄風險類型與檔案位置,不複製敏感值。
  2. 立即暫停。
  3. 請用戶確認其有權處理這些材料,或請用戶提供脫敏副本。

未經用戶確認,不繼續提綱、寫作和交付。

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.md
  • 06_one-page-summary.md
  • 07_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/ 為空或材料無法讀取。
  • 用戶未確認敏感材料可以繼續處理。
  • 接收者、交付類型或核心目標仍不明確。
  • 當前材料無法支援主要結論。
  • 用戶尚未確認任務單或提綱。

不要用虛構材料、聯網搜尋或常識推斷繞過停止條件,除非用戶另行明確授權新的資料來源。

輸出語言

預設跟隨用戶當前使用的語言。檔案名稱保持英文,便於跨環境使用;檔案內容使用用戶語言。

相關技能