From 93b7f52ca9f1ac9a54048dee282dfe87ad964bc5 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 14:13:27 +0800 Subject: [PATCH] =?UTF-8?q?feat(meta):=20STE100=20=E6=93=AC=E4=BA=BA?= =?UTF-8?q?=E5=8F=B0=E7=81=A3=E6=84=9F=E8=A6=8F=E5=89=87=E2=80=94=E2=80=94?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=20references/ste100.md=EF=BC=88=E6=94=B9?= =?UTF-8?q?=E5=AF=AB=E8=87=AA=20speak-human-tw=EF=BC=8CMIT=EF=BC=89?= =?UTF-8?q?=E4=B8=A6=E6=9B=B4=E6=96=B0=E6=BA=96=E5=89=87=E8=AA=9E=E8=A8=80?= =?UTF-8?q?=E7=AF=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- AGENTS.md | 2 +- references/guidelines.md | 2 +- references/ste100.md | 60 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 62 insertions(+), 2 deletions(-) create mode 100644 references/ste100.md diff --git a/AGENTS.md b/AGENTS.md index 9a3723c..644d166 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ ## 規則 -1. 所有交談與輸出內容基於 STE100 使用繁體中文：短句、一句一指令、主動語態、術語一致、UTF-8 無亂碼。 +1. 所有交談與輸出內容使用 STE100 繁體中文，帶擬人台灣感：短句、一句一指令、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源：`plugins/meta` 的 `references/ste100.md`。 2. 技能位於 `skills/{name}/SKILL.md`；處理任務前先比對需求與各技能的 `description`，相符就載入並依其步驟執行。 3. 技能準則的唯一來源：`plugins/meta` 存取庫的 `references/guidelines.md`。 4. 所有 hook 只放在 `jsc-hooks`；gitea 操作一律經由 `jsc-gitea` 的 `tools/gitea.sh`；問使用者一律依 `jsc-ask:ask` 的決策樹規則。 diff --git a/references/guidelines.md b/references/guidelines.md index 5463754..ff1b669 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -40,7 +40,7 @@ ## 語言 -1. 所有交談與輸出內容基於 STE100（簡化技術中文）使用繁體中文：短句、一句一指令、主動語態、術語一致、UTF-8 無亂碼。 +1. 所有交談與輸出內容使用 STE100 繁體中文，帶擬人台灣感：短句、一句一指令、主動語態、術語一致、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源：[`references/ste100.md`](ste100.md)。 2. SKILL.md 的 `description` 為英文（見上），內文為繁體中文。 ## 撰寫規範（SKILL.md 內文） diff --git a/references/ste100.md b/references/ste100.md new file mode 100644 index 0000000..af9eb1a --- /dev/null +++ b/references/ste100.md @@ -0,0 +1,60 @@ +# 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、引號內原話。