wmtw-briefs/README.md

維基國際短訊 自動化

每週自動產生維基媒體運動「國際短訊」，用本機 mail 寄給秘書長過目、篩選後採用至月訊。 台灣維基媒體協會用。

短訊的產生規則（來源、挑選、翻譯、格式、收件人、寄送方式）全部寫在 wmtw-briefs.md， 本文件不重複，只談簡介、部署與維護。

運作方式：cron 每週觸發一次 Claude Code headless（claude -p），把 wmtw-briefs.md 當提示 餵進去，它讀 wikimedia-l 過去七天內容、產繁中純文字短訊、用本機 mail 寄出，全程無人工介入。 用訂閱登入憑證執行，不另計付費 API。

部署

前置需求

執行 cron 的主機需具備：

• Claude Code CLI，且已用會員帳號 /login 過（headless 才有訂閱憑證、不另計費）； cron 須掛在這個已登入的使用者底下。
• 本機 mail（如 exim4／sendmail，免 SMTP 認證即可送出）。
• locale zh_TW.UTF-8（中文主旨與內文才正常）。

步驟

部署位置（系統路徑、crontab）為固定處所，以下用絕對路徑；其餘指涉本專案檔案處皆用相對路徑。

1. 把指示檔放到系統位置：

   sudo cp wmtw-briefs.md /etc/wmtw-briefs.md
   

2. 找出 claude 執行檔的完整路徑（cron 的 PATH 很精簡，必須寫完整路徑）：

   command -v claude
   

3. 在已登入會員帳號的使用者底下 crontab -e，加入下列一行 （把 <claude完整路徑> 換成上一步結果）：

   0 18 * * 1 <claude完整路徑> -p "$(cat /etc/wmtw-briefs.md)" --allowedTools WebFetch Bash >> /tmp/wmtw-briefs.log 2>&1
   

   • 0 18 * * 1：每週一 18:00，可自行調整時段。
   • headless 放行的工具：WebFetch、Bash。
   • 收件人寫在 /etc/wmtw-briefs.md 裡，不在 crontab。

維護

• 改產生規則或收件人：編輯部署後的 /etc/wmtw-briefs.md，不必動 crontab。
• 沒收到信：查 crontab 導向的 log；確認郵件佇列沒卡（mailq）； 確認 claude 訂閱憑證未過期（在該使用者底下重跑互動式 claude，若要求重新登入即為過期）。
• 中文亂碼：檢查 crontab 那行有沒有帶 LANG=zh_TW.UTF-8。
• 內容偏少：wikimedia-l 某些週本來就稀疏，指示檔已交代據實產短、不硬湊，屬正常。
• 上線前測試：複製一份指示檔、把收件人改成自己（勿寄秘書長），手動跑 <claude完整路徑> -p "$(cat <測試指示檔>)" --allowedTools WebFetch Bash， 確認中文、純文字排版與內容無誤後再正式啟用。