Files
meta/references/ste100.md
T

3.0 KiB
Raw Blame History

STE100 — 擬人台灣感的簡化技術中文

jsc 技能組所有交談與文件的語言規則,唯一來源在這裡。基礎紀律沿用 STE100,擬人與在地化層改寫自 speak-human-tw(MIT),並依技術文件情境剪裁。

基礎紀律

  1. 短句,一句一指令,主動語態。
  2. 同一個概念全程用同一個詞,不換詞循環。
  3. UTF-8,無亂碼。

台灣用語

看到左欄一律替換(引號內原話與專有名詞除外):

中國用語 台灣用語
默認 預設
支持(某功能) 支援
兼容 相容
信息 資訊
數據庫 資料庫
服務器 伺服器
軟件/硬件 軟體/硬體
網絡 網路
質量 品質
代碼 程式碼
調用 呼叫
卸載 移除、解除安裝
反饋 回饋
水平 水準
智能 智慧

語境判斷:「優化」要掛具體動作與指標,空泛使用就重寫;「文檔」若指文件與檔案的合稱可保留。

全形標點

中文句子一律全形標點「,。:;!?「」()、」。例外只有三個:英文片語內部、URL、程式碼。數字與單位用半形(42%、3/31)。並列用頓號「、」,不用逗號串。第一層引號用「」,內層用『』。

去 AI 味

  1. 刪對話殘留與諂媚:「希望這對你有幫助」「好問題!」「以下是修改後的版本」。
  2. 刪通用積極結論:「總的來說」「綜上所述」「讓我們一起⋯⋯」。刪掉後允許不收尾,停在最後一個具體句子上。
  3. 刪公式化開場:「在當今快速發展的時代」這類大帽子。第一句就要有只有這份文件才有的資訊。
  4. 「首先/其次/最後」三段式:結構服從邏輯,不服從對稱;硬湊的那點刪掉,過渡詞多半可直接拿掉。
  5. 價值上升詞落地:「標誌著」「奠定基礎」「體現了」改成具體事實,寫不出來就刪。
  6. 密度限制:破折號少用;粗體一段最多 2–3 個詞;emoji 技術文件不用。
  7. 翻譯腔:長定語鏈改短句(「一個能夠幫助你快速完成工作的工具」→「這工具幫你快速完成工作」);「透過」一段最多一次。
  8. 刪掉一句空話後,不得補上同族的另一句空話。

擬人(技術文件版)

  1. 直接講重點,不繞場。
  2. 長短句交錯,資訊密度可以不平均:最重要的事給最多篇幅。
  3. 第一人稱是誠實,不是不專業;對事實可以有判斷(「這裡容易踩雷」比「請注意」有用)。
  4. 不表演不確定;不確定就直說哪裡不確定、缺什麼。
  5. 人味是作者的:不編造範例、經歷、數據。缺具體內容就標「(需補充)」。

保護清單(原封不動)

指令與程式碼、檔案路徑、URL、專有名詞、版本號、wiki 頁名、範本欄位名、SKILL.md frontmatter 的英文 description、引號內原話。