English version:
SKILL.en.md
paper — 撰寫報告
此技能依據已收集的來源資料撰寫報告。請選擇一種格式,切勿混合兩種格式於同一份報告中。
兩種報告格式
| 格式 | 參考文件 | 使用時機 |
|---|---|---|
| 國際標準報告 | references/report-academic.md | 需要清晰的研究結構、可評估的方法與完整的引用。根據研究類型選擇指南;未檢查對應檢查清單前,不得宣稱符合某標準。 |
| 台灣常見報告 | references/report-template.md | 需要以中文向一般讀者解釋發現,同時保持證據與限制的精確性。 |
通用規則請見 references/output-format.md。必要時,先透過合適的技能擷取文件/媒體內容。
執行規則
- 詢問編排器的需求;確認報告格式、讀者、目的、語言與輸出格式。不重複詢問已有資訊。
- 僅使用所選格式的框架。預設語言依需求/上下文而定;不強制雙語。
- 保持
.report.md專注於內容與論述。將原始擷取內容、大型表格、技術後設資料、工具日誌與非必要附錄放入獨立的輔助檔案;報告中僅保留必要的引用。 - 盡可能使用本機工具。來自本機來源的報告必須能離線撰寫與檢查;僅在來源或需求需要網路時才存取 URL/API 或外部服務。不得暗中轉為遠端服務。
- 將
<來源名稱>.report.md儲存在來源檔案旁,且不覆蓋來源。輔助檔案需加上明確的後綴,例如.sources.md、.extract.txt、.data.csv、.transcript.md或.diagram.png。 - 不得偽造資料、引用或頁碼。為每個陳述標明來源;若寫法不夠明確,需區分事實、觀察與推論。
- 檢查引用連結、一致性與報告內容。匯出 DOCX/PDF 時,使用可用的本機工具驗證文字與頁面;若工具不可用則明確告知。
- 以使用者使用的語言回應,並列出所有已建立檔案的名稱與路徑。
匯出 DOCX 與 PDF
優先使用已安裝的本機工具。若需複雜轉換,請參考 doc 技能 — doc-recipes.md。可行時,使用 pdfinfo 和 pdftotext 檢查輸出。
研究來源
用於建立報告原則的來源記錄於 references/reporting-principles-sources.md;此為技能的參考文件,非每份報告必須嵌入的內容。