論文格式代理 是做什麼的?
使用此技能進行本地優先的學術文件格式化工作。它專為 .docx 論文以及 .docx、.doc 或 .txt 格式的獨立格式規範而設計。
安全預設
- 除非使用者明確要求,否則絕不將私人論文或格式指南上傳至外部服務。
- 將學生論文、手稿、審稿意見和學校模板視為敏感資料。
- 除非使用者明確選擇加入,否則不得更改學術內容。預設僅進行格式化變更。
- 將報告和產生的文件保存在使用者提供的輸出目錄中。
標準工作流程
- 確認輸入檔案:
--format-file:格式指南或模板文字。--paper-file:原始論文,目前為.docx格式。--out-dir:輸出目錄,用於存放報告和產生的文件。
- 以僅格式化模式執行 CLI:
python -m paper_format_agent.cli \
--format-file "format_guide.docx" \
--paper-file "paper.docx" \
--out-dir "./output" \
--engine auto \
--strict-required-sections
- 檢查產生的工件:
formatted_paper_v3.docx:修復後的文件。format_rules.json:提取的規則。format_report.json:機器可讀的分數與檢查結果。format_report.html:人類可讀的報告。modify_log.json:格式化操作記錄。engine_report.json:後處理引擎結果。
- 檢查
format_report.json中的內容保護欄位:content_changed通常應為false。content_guard_enforced通常應為true。
- 如果規則有誤,請更新規則提取或評分邏輯,並加入最簡測試案例。
驗證
在回傳工作成果前,請執行以下步驟:
python tools/validate_skill.py
python -m unittest discover -s tests -p "test_*.py"
python tools/compile_check.py
python tools/release_audit.py
新增模板支援時
- 加入重現該行為所需的最少代表性規則文字。
- 優先使用確定性規則提取,而非僅依賴 LLM 解讀。
- 針對提取的邊距、字型大小、行距、必要章節、標題、圖表標題或參考文獻加入測試。
- 請勿提交真實的學生文件。請使用合成文字或匿名處理的測試資料。
審查輸出時
首先閱讀 format_report.json,如果使用者需要人類可讀的摘要,再檢查 format_report.html。請依以下順序優先處理問題:
- 內容意外變更。
- 必要章節或標題分類錯誤。
- 頁面設定、邊距、字型或行距錯誤。
- 圖表標題、參考文獻、表格或編號看起來錯誤。
- 報告用詞或分數說明不清楚。
適合貢獻的任務
良好的首次 PR 通常屬於以下類別之一:
- 為某學校、期刊或會議的格式化規則新增合成測試。
- 使用範圍明確的正規表達式或解析器改進規則提取器。
- 在不改變評分語義的前提下改善報告清晰度。
- 在
docs/regression_manifest.sample.json中新增迴歸案例。 - 改進此技能工作流程或
agents/openai.yaml中繼資料。