MrGeDiao/shuorenhua

shuorenhua (說人話) – 中文AI風「人話化」技能

是什麼 – 一個可插入LLM驅動代理（Codex、Claude Code、Cursor、ChatGPT等）的輕量級 技能，用於重寫中文文本，使其不再聽起來像通用AI生成的回應。它移除典型的「AI語氣」模式（過度禮貌的開場、工程師用語、行銷術語、翻譯腔、無來源的權威主張），同時 保留所有事實細節 —— 數字、版本、命令、錯誤訊息、引用和時間戳均保持原位不變。

為何使用

場景	shuorenhua 的作用
非正式聊天	剪除冗餘開場和銷售式結尾，保持對話自然流暢。
技術狀態更新	保留事實、版本號、命令片段和錯誤日誌，同時清除空洞的「進展」語言。
README / 發布說明	展示清晰的變更列表、版本、驗證步驟和限制——無促銷性贅述。
論壇貼文 / 問題回覆	讀起來像一位負責的維護者，而非模板化公告。
長篇中文文章	移除空話，以 「建議刪除」 形式列出，供人工審核，確保原文長度和關鍵資訊完整保留。

如何運作

1. 場景檢測 – 判斷輸入是聊天、狀態、文件還是公開寫作，並載入相應的 場景包（README、發布說明、論壇帖等）。
2. 保護段提取 – 自動鎖定數字、版本字串、檔案路徑、命令列、錯誤追蹤、姓名和責任聲明。
3. 強度分級 – 將文本分為 Tier 1/2/3，並選擇重寫強度（最小 / 標準 / 激進）和作用範圍（結構 / 限定 / 就地）。
4. 模式化重寫 – 應用精心篩選的中文AI風格模式詞典；並非盲目查找替換。
5. 保真度檢查 – 重新閱讀輸出，確保所有保護段和事實關係未被更改。
6. 殘留審計 – 第二輪輕量級處理，僅修復殘留的「AI味」餘渣。

規則集位於 references/（正向風格指南、保護段列表、場景包定義），刻意嚴格：數字必須與物件綁定，關係不可更改，時間跨度不可縮短，不可虛構新事實。

快速上手（約30秒）

• ChatGPT (Plus/Pro) – 使用托管的 「說人話 GPT」 連結；貼上文字並要求「把這段去 AI 味」。
• Claude Code – 執行 README 中顯示的兩個插件命令，然後輸入 把這段去 AI 味。
• Codex – 克隆倉儲並執行一行命令，如：

  codex exec -C . "讀取 ./SKILL.md，按其中規則改寫以下文本：…"
  

• 其他代理 – npx skills add MrGeDiao/shuorenhua（或參考平台特定的 install/*.md 文件）。

對於長篇文件，可請求 註解模式（只註解不改寫），取得建議刪除項目列表但不實際刪除內容。

評估

• evals/benchmark.md 提供 103個案例（57個「必須改」，46個「必須留」）的公開基準測試。
• 按模型（Codex、Claude）報告結果，包含硬約束失敗（L1）、誤報率（SNF）和風格目標指標（L2）。最新版本（v2.3.0）在盲測集上實現0次硬約束失敗，誤報率低於10%。
• 自動化腳本（automation/eval/hard_metrics.py）可計算長文本運行中的長度保持、連字符密度和保護段完整性。

安裝

平台	文件
Codex	install/codex.md
Claude Code	install/claude-code.md
Cursor / Windsurf	install/cursor.md
OpenClaw	install/openclaw.md
ChatGPT / 自訂GPT	install/chatgpt.md

技能核心為單一檔案 SKILL.md；如需完整功能（場景包、保護段列表），請包含 references/ 目錄。

許可證 – MIT。

---

TL;DR – shuorenhua 是面向LLM代理的中文「人話化」技能，剝離AI風格模板的同時保證事實準確性。透過規則驅動的模式匹配、場景感知的強度設定和雙輪驗證流程實現，附帶全面基準測試和主流AI助手平台的簡易安裝。