前言¶
給老師、校長或教育工作者寫一篇能直接發學校網站、公衆號和教育刊物的圖文通訊,常見的做法是:先翻聊天記錄找事蹟,再上網搜幾張照片,最後手工在 Word 裏調字號行距。圖片來源說不清、人名職務對不上、排版跟公文規範不一致,是這類稿件最容易出問題的地方。下面介紹的 Skill 把這條鏈路固定成可重複執行的步驟,減少臨場發揮帶來的事實錯誤和無圖交付。
這是什麼¶
教師新聞通訊稿撰寫技能2.0,座標 @user_e636a7a0/teacher-news-feature,由社區作者 user_e636a7a0 發佈維護,當前版本 2.0.2,分類 content-creation,標籤含新聞通訊、教師報道、人物專訪、公文排版、教育宣傳、docx 生成,不需要 API key。官方地址:https://api.skillhub.cn/user_e636a7a0/teacher-news-feature ,SkillHub 頁面:https://www.skillhub.cn/skills/user_e636a7a0/teacher-news-feature 。
它解決的是「人物中心、圖文並茂的新聞通訊」的完整產出問題:公開資料採集、事實覈驗、配圖獲取與標註、正文撰寫、公文格式排版、docx 生成與歸檔。它不是活動簡訊工具——如果手上是講座、培訓、活動的錄音轉寫稿或方案,只需要一篇簡短的活動導向新聞,應改用 news-brief-generator。
核心功能¶
按官方簡介,這條流水線包含六個環節:
- 採集:從網絡與微信公衆號抓取公開資料,作爲人物經歷與事蹟的事實來源。
- 覈驗:人名、單位、職務、時間必須準確;公開資料與用戶說法矛盾時,必須詢問用戶確認,不得自行取捨或虛構。
- 配圖:下載真實新聞圖片,並逐張標註來源。
- 撰寫:產出含標題、導語、正文、結語的新聞通訊結構。
- 排版:按 GB/T 9704-2012 公文格式排版。
- 歸檔:用 python-docx 生成 .docx,寫入「日期+任務名稱」文件夾。
配圖是這條流水線上的強制項。簡介寫明:無配圖或低於合格下限(≥3 張,推薦 4–6 張)的文檔一律視爲不合格,流程上直接攔截,不允許交付無圖通訊。攔截邏輯放在 docx_template.py 的 verify_image_completeness() 中。
內置的標準化能力還包括:
- 統一的 Python 運行時與依賴規範。官方給出的理由是規避 Windows 精簡 shell 缺少命令導致管道或落盤靜默失敗。
- 圖片「抓取 → 提鏈 → 關聯圖注 → 下載校驗 → 壓縮」流水線,壓縮參數爲長邊 ≤1600、JPEG q82,目標是把 docx 從 20MB 級壓到 1MB 級。
- 生成或改稿後的 Python 讀回校驗規範。
- 騰訊文檔本地編輯器(editor_sdk)改稿流程,其中一條硬規則是
save_file必須顯式傳file_path,否則不會落到用戶真實文件。
安裝與啓用¶
SkillHub 頁面抓取失敗,以下命令未能從官方頁面覈實,不在此虛構。安裝方式以官方頁面爲準。可覈實的信息只有:版本 2.0.2,來源 community,分類 content-creation,requires_api_key=false,無需配置密鑰。
啓用方式依賴 Skill 的觸發詞機制。官方簡介列出的觸發詞包括:新聞通訊、人物通訊、教師事蹟、老師報道、「寫一篇關於X老師的文章」、「爲X老師寫篇通訊稿」、報道某老師、教師風采。按此設計,用戶沒有顯式提「技能」也應啓用。本 Skill 基於通用 SKILL.md 格式,具體字段需以隨包 SKILL.md 爲準。
典型用法¶
官方簡介未提供可復現的命令示例,下面只描述調用時應滿足的輸入與校驗,具體參數需查閱隨包文檔。
一條典型調用是:給出人物姓名與單位,要求撰寫一篇教師通訊。流程上先執行採集與覈驗,遇到公開資料與口述不一致時停下來向用戶提問;再執行配圖與正文撰寫,最後生成 docx 並歸檔。
驗收時至少有三項可自查:
- docx 中圖片數量不低於 3 張,且每張圖都有來源標註。
- 正文人名、單位、職務、時間與覈驗結果一致,未被改寫。
- 文件已落到「日期+任務名稱」目錄,且通過 Python 讀回校驗。
適用場景與注意¶
適合需要爲單一人物產出深度通訊、並且要同時滿足學校網站、公衆號、教育刊物三處發佈要求的場景。
使用時注意三點:
- 事實口徑以覈驗結果爲準。公開資料與用戶說法衝突時,Skill 的設計是詢問用戶,而不是自行選擇更可信的一方。如果用戶未回覆,應當停下而不是繼續寫。
- 配圖下限是硬約束,不是建議。少於 3 張會被
verify_image_completeness()攔截,不要通過手工繞過來交付無圖或少圖文檔。 - 圖片壓縮參數固定,長邊 1600、JPEG q82。如果手頭有更高分辨率需求,需確認後再調整,不要直接改腳本參數。
此外,Windows 環境需要使用 Skill 自帶的 Python 運行時與依賴規範,不要依賴系統 PATH 中的 python,否則可能出現管道或落盤靜默失敗,表現爲命令「成功」但文件沒寫出來。
小結¶
這個 Skill 的價值在於把人物通訊從「邊寫邊找資料」變成固定流水線:採集 → 覈驗 → 配圖 → 撰寫 → 排版 → 歸檔,並在配圖數量和落盤校驗上設置攔截點。適合需要批量、規範地產出教師宣傳稿的場合。官方地址:https://api.skillhub.cn/user_e636a7a0/teacher-news-feature 。