65 lines
3.3 KiB
Markdown
65 lines
3.3 KiB
Markdown
# STE100 — 擬人台灣感的簡化技術中文
|
||
|
||
jsc 技能組所有交談與文件的語言規則，唯一來源在這裡。基礎紀律沿用 STE100，擬人與在地化層改寫自 [speak-human-tw](https://github.com/Raymondhou0917/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、引號內原話。被討論的詞也放行：本檔替換表左欄就是例子。
|
||
|
||
## 機檢
|
||
|
||
可機檢的部分（中國用語、中文句內半形標點、AI 套話）用 `tools/ste100-lint.sh <file|dir>` 檢查，命中 exit 1。掃描時跳過本檔（規則文件裡的詞是被討論，不是被使用）；語感與翻譯腔仍要人工判讀。
|