tw-formal-writing

English | 中文

台灣正式文件撰寫 AI Skill

為什麼公文寫作很重要？

公文不只是形式。一份寫對的公文，能讓案子順利推動；一份寫錯的公文，輕則退件重寫、延誤時效，重則造成法律爭議或機關間的誤解。

公務員面臨的現實：

• 新進人員沒受過完整公文訓練，邊寫邊猜、邊被退件邊學
• 引敘語「奉/准/據」、稱謂語「鈞/貴/大」、期望語「請鑒核/請查照」搞不清楚，用錯就是失禮
• 簽辦方式（先簽後稿、簽稿併陳、以稿代簽）選錯，整個流程要重來
• 早已取消的結尾語（為要、為荷、為禱）還在用，被長官圈起來退回

一般民眾面臨的現實：

• 想向政府陳情、申請、訴願，但完全不知道格式怎麼寫
• 需要寄存證信函給房東，但不確定法律用語對不對
• 訴願書有 30 天法定期限，寫錯格式被退件就來不及了

這個 Skill 解決什麼問題：

• 匯入你慣用的 AI 工具（ChatGPT、Claude、Gemini），用口語描述情境，AI 就能產出符合《文書處理手冊》及《公文程式條例》規範的正式文件
• 自動選用正確的用語、格式、簽辦方式
• 產出後自動執行品質檢核，攔截常見錯誤
• 已寫好的公文也能貼入請 AI 幫你檢查修改

涵蓋範圍

類別	文件類型
政府公文	簽、函、書函、令、呈、咨、公告、箋函、便簽
政府其他文件	會議紀錄、開會通知單、新聞稿、施政報告、聘函、獎狀
法律文件	存證信函、合約書、律師函、備忘錄(MOU)、聲明書、切結書、委託書
人民對政府	陳情書、申請書、訴願書、異議書

最新版本亮點（v1.5.2）

v1.5.2：對照《文書處理手冊》、行政院兩份釋例彙編與國家文官學院《公文撰作解析》（114 年 12 月版）逐項查核，修正規範中誤解原文、誤引原文或查無出處的內容，例如「上行函不用第三段」「簽於何處只寫最末級單位」「中文函不夾英文」等說法，並更正多處釋例日期與附錄號。只見於教材、手冊未規定的慣例（如奉／准／據的方向、上行函不用「辦法」段名、公告不寫期望語），檢核由「錯誤」改為「警告」，並寫明警告是提醒使用者、說明依據，由使用者決定是否修改；釋例與教材說法不同之處兩邊並列。另依教材補入分對象的准駁語、期望語及「抄發」。各版本收到哪些改動見 CHANGELOG。各平台都未做模型實測。

v1.5.1：對照目前 Claude 模型照字面遵循指示的特性，盤點並調整規範寫法。公文第一步的資訊確認改為能從描述推知的直接判斷，推知不了且會影響寫法才詢問；另刪去 SKILL.md 一行強調說明，並修正三處內容錯誤。公文規範的改動也進入 STANDALONE.md 完整單檔與 Codex、Gemini 入口檔，各版本收到哪些改動見 CHANGELOG。各平台都未做模型實測。

v1.5.0：新增 12組案件場景指引：催辦、展期、補正、否准、陳述意見通知、陳情答復與移轉、原函更正、會辦便簽、會勘、會議後續、箋函、公務電話紀錄。每組提供必要資訊、文別判斷及撰寫重點；單檔版收於附錄六，多檔 skill 依需求選讀。

同時修正先簽後稿的產出順序、會議紀錄與通知單欄位、救濟教示的過度概括，以及舊範例誤判「依據」的問題。新增 涵蓋度與後續缺口盤點、20題行為檢查規格與案件後續範例。法規預告、會銜完整流程、採購及資訊公開等仍需專章補強，未列為完整支援。

v1.4.1：修正 v1.4.0 的幾個文件與腳本小瑕疵，包括 README 的更新指令、單檔版一處指向不存在檔案的死連結，以及一個 macOS 暫存檔會讓本機檢查誤報的問題。不動規範內容，詳見 CHANGELOG。

v1.4.0：本 repo 同時是一個 Claude Code plugin marketplace，可直接用 /plugin marketplace add 安裝（見下方「Claude Code」段），CLI 與桌面版皆適用。同時修正 plugin 模式下讀不到規範內容的問題，並移除 repo 內全部 symlink（Windows clone 會失效）。

v1.3.0：規範內容的批次補強，對照《文書處理手冊》112 年版全文與行政院兩份釋例彙編逐條第一方核對，修正三處既有錯誤依據，並補齊惠字用法、數字日期時間金額細則、行款欄位規則、法律統一用字表全表等。詳見 CHANGELOG。

三個版本

檔案	大小	適用場景
LITE.md	精簡摘要	ChatGPT GPTs Instructions（有字數限制）
STANDALONE.md	完整單檔	檔案上傳（含6個附錄與品質檢核）
SKILL.md + references/	多檔案	Claude Code 等支援多檔案的工具
skill.zip（Releases 附件）	打包	claude.ai / cowork 等可上傳 skill 包者

跨 vendor 入口：根目錄的 AGENTS.md / GEMINI.md（內容即 STANDALONE.md 完整單檔）供 Codex / Gemini 等 CLI 直接讀取；.claude-plugin/ 下的 plugin.json 與 marketplace.json 讓本 repo 同時是 Claude Code plugin 與 plugin marketplace，可用 /plugin marketplace add 直接安裝。一份內容、多種入口。

給貢獻者：references/ 是規範的單一真實來源。STANDALONE.md、skills/tw-formal-writing/、AGENTS.md / GEMINI.md 皆由 scripts/build.py 自動生成，請勿手動編輯——改規範請改 references/ 後跑 python3 scripts/build.py 重新生成。LITE.md 是手動維護的有損壓縮版，但 scripts/check_consistency.py 會檢查它沒漏掉關鍵規則錨點。發布用的 skill.zip 由 python3 scripts/package.py 以純 Python 打包（SKILL.md + references/ + examples/ + LICENSE，頂層資料夾 tw-formal-writing/）；--check 只驗清單不寫檔、--release 打包後自動建 GitHub Release。CI 會 gate 這幾項（含打包清單齊全）。

匯入方式

ChatGPT GPTs

方法 A（推薦）：上傳完整版

1. 前往 ChatGPT → My GPTs → Create a GPT
2. 在 Configure → Knowledge 上傳 STANDALONE.md
3. Instructions 欄位貼入：

   你是台灣正式文件撰寫專家。請依照 Knowledge 中的 STANDALONE.md 規範，
   協助使用者撰寫公文及正式文件。先判斷文件類別，再依對應規範撰寫。
   產出後執行品質檢核。
   

方法 B：直接貼入精簡版

1. 前往 My GPTs → Create a GPT
2. 將 LITE.md 的全部內容貼入 Instructions 欄位

ChatGPT Projects

1. 前往 ChatGPT → Projects → 新建或選擇 Project
2. 在 Project 設定中，上傳 STANDALONE.md 作為 Project Files
3. 開始對話即可使用

Claude (claude.ai)

1. 前往 Claude → Projects → 新建 Project
2. 在 Project Knowledge 上傳 STANDALONE.md
3. 在該 Project 中開始對話

Claude Code（含桌面版）

方法 A（推薦）：從 marketplace 安裝 plugin

本 repo 即是一個 Claude Code plugin marketplace。在 Claude Code（CLI 或桌面版）中執行：

/plugin marketplace add Imbad0202/tw-formal-writing
/plugin install tw-formal-writing@tw-formal-writing

之後用 /plugin 進選單即可啟用或停用。要更新到新版，在終端機執行 claude plugin update tw-formal-writing，更新後重啟 Claude Code 生效。

方法 B：手動 clone 成 skill

# 全域安裝（所有專案可用）
mkdir -p ~/.claude/skills
git clone https://github.com/Imbad0202/tw-formal-writing.git ~/.claude/skills/tw-formal-writing

# 專案內安裝
mkdir -p .claude/skills
git clone https://github.com/Imbad0202/tw-formal-writing.git .claude/skills/tw-formal-writing

claude.ai / cowork

至 Releases 下載 tw-formal-writing-skill-vX.Y.Z.zip，於 claude.ai 或 cowork 上傳載入。

Codex / Gemini 等 CLI

git clone https://github.com/Imbad0202/tw-formal-writing.git

clone 後於工作目錄即可使用：根目錄的 AGENTS.md（Codex 等）/ GEMINI.md（Gemini CLI）內容即 STANDALONE.md 完整單檔，agent 會自動讀取。

Codex 預設自動載入 AGENTS.md 的上限是 32 KiB，而完整單檔超過 100 KiB，所以只會載入公文規範的前段（約到稱謂語），之後的期望語、品質檢核關卡與其他類別都不會自動載入。要讓 Codex 載入完整規範，請在 Codex 設定檔 ~/.codex/config.toml 最前面、任何 [...] 段落標題之前加入下面這一行（放在段落標題之後會被當成該段落的設定，不會生效），或在執行 Codex 時加上 -c project_doc_max_bytes=262144：

project_doc_max_bytes = 262144

Gemini Gems

1. 前往 Gemini → Gems → 新建 Gem
2. 依當下介面提供的容量使用完整單檔；若指示欄位容納不下，改採精簡版，並在介面支援時附上 STANDALONE.md 作為參考檔。完整內容會隨版本增加，不保證可直接貼入所有平台的指示欄位。

注意事項

依行政院及所屬機關（構）使用生成式 AI 參考指引，機密文書應由承辦人親自撰寫，禁止使用生成式 AI 輔助。使用本工具時，請勿輸入涉及機密、未經機關同意公開之資訊，或與案件無關的個資。若屬人民對政府文書，僅提供該程序必要的最小識別與聯絡資訊；除非相關法規、機關表單或案件流程明文要求，避免輸入身分證字號、證件影本等高敏感資料。

這個 skill 提供的是通用指引，不是標準答案或唯一寫法，立場與《文書處理手冊》一致。各機關的慣用寫法歡迎 fork 後客製化。

使用範例

貼入或上傳完成後，直接跟 AI 說：

• 「我是衛生局的承辦人，需要發函通知各醫療院所下個月要交傳染病統計表」
• 「幫我寫一份簽呈給局長，報告今年度預算執行情形」
• 「我要公告裁罰違規食品業者的結果」
• 「我想寄存證信函催房東退還押金」
• 「幫我寫陳情書向市政府反映噪音問題」
• 「我是承辦人，這封函已經發出但附件有錯，幫我整理更正內容及需要確認的資訊」
• 「我是主辦科承辦人，要請主計室會辦經費表，計畫尚未核定，請擬便簽」

AI 會自動判斷文件類別、確認必要資訊、產出合規文件、執行品質檢核。

依據

• 行政院《文書處理手冊》（112 年 6 月 8 日修正）
• 《公文程式條例》
• 國家文官學院《公文撰作解析》（114 年 12 月編印）：公開版 PDF
• 文書處理相關釋例－函釋（更新至 115.4.30）
• 文書處理相關釋例－院長電子信箱（更新至 115.8.31）
• 全國法規資料庫《行政程序法》：https://law.moj.gov.tw/LawClass/LawAll.aspx?media=print&pcode=A0030055
• 全國法規資料庫《訴願法》：https://law.moj.gov.tw/LawClass/LawAll.aspx?media=print&pcode=A0030020
• 國家發展委員會《行政院及所屬各機關處理人民陳情案件要點》：https://theme.ndc.gov.tw/lawout/LawContent.aspx?id=GL000017

支持這個專案

如果這個工具對你有幫助：

• 按個 Star 讓更多人看到
• 分享給同事、同學、或任何需要寫公文的人
• Buy Me a Coffee 支持開發者持續更新
• 發現問題或有建議？歡迎開 Issue

作者

Cheng-I Wu — GitHub | Buy Me a Coffee

授權

MIT License — 自由使用、修改、分享。