From 19303ca555509b2987327702ee07422bb04dc5e7 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 27 Aug 2026 09:42:51 +0800 Subject: [PATCH] =?UTF-8?q?feat(ste100):=20=E8=AA=9E=E8=A8=80=E8=A6=8F?= =?UTF-8?q?=E5=89=87=E7=B4=8D=E5=85=A5=E9=81=A9=E7=94=A8=E7=AF=84=E5=9C=8D?= =?UTF-8?q?=E8=88=87=E7=B7=A8=E7=A2=BC=E8=A6=81=E6=B1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What - `references/ste100.md` 新增「適用範圍」與「編碼」兩節，並以表格列出各類輸出是否適用。 - 「機檢」一節補上新的類別清單與文件檔、程式碼檔的分流說明。 - `references/guidelines.md`「語言」第 1 條改寫成「所有非程式碼輸出一律繁體中文、UTF-8、 無亂碼、無簡體字」，並以一行指引指回 `references/ste100.md`。 - 「審核檢查清單」新增一個可勾選項目，涵蓋非程式碼輸出的語言與編碼，且要求機檢全綠。 Why - 舊條文只講「交談與輸出內容」用 STE100 繁中，沒有把程式碼註解、commit 訊息、PR 描述、 wiki 頁這些實際會產出的東西點名，執行時容易各自解讀。 - 編碼要求原本只有基礎紀律裡的一句「UTF-8，無亂碼」，沒有說明什麼算亂碼，也沒有寫明 不得出現簡體字，機檢與人工判讀對不上。 How - 適用範圍用表格逐項標「是」或「否」，並明講程式碼識別字、關鍵字、API 名稱不受限， SKILL.md 維持整份英文。 - 編碼用表格寫要求、內容與常見違規，違規範例直接對應機檢的「亂碼」類別。 - 細節只寫在 `references/ste100.md` 一處，guidelines.md 只留摘要與指引，維持單一真實來源。 Who - 影響所有 jsc 技能的輸出與審核；撰寫技能與跑 `jsc-meta:skill-check` 的人要照新清單檢查。 --- references/guidelines.md | 3 ++- references/ste100.md | 29 +++++++++++++++++++++++++++-- 2 files changed, 29 insertions(+), 3 deletions(-) diff --git a/references/guidelines.md b/references/guidelines.md index 2cd4d4b..d9012b5 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -40,7 +40,7 @@ ## 語言 -1. 所有交談與輸出內容使用 STE100 繁體中文，帶擬人台灣感：短句、一句一指令、主動語態、術語一致、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源：[`references/ste100.md`](ste100.md)。 +1. **所有非程式碼輸出**一律 STE100 繁體中文、UTF-8、無亂碼、無簡體字，帶擬人台灣感：短句、一句一指令、主動語態、術語一致、台灣用語、全形標點、去 AI 味、直接講重點。範圍涵蓋程式碼註解、commit 訊息、PR 描述、wiki 頁、對使用者的回報、README 與各種文件；程式碼本身（識別字、關鍵字、API 名稱）不受此規則限制。完整適用範圍表、編碼要求與替換表的唯一來源：[`references/ste100.md`](ste100.md)。 2. **技能文件（SKILL.md）整份為英文**：frontmatter 與內文都是。風格比照 STE100：短句、祈使句、術語一致。 3. 技能文件裡「要原樣輸出的繁中字面內容」保留繁中：wiki 狀態字串（例：已分析、未完成）、hook 注入文字、要寫進 wiki 或 commit 的文案。技能執行時產生的 commit 訊息、PR 描述、wiki 頁內容仍依第 1 條輸出繁中。 4. README、AGENTS.md、`templates/`、`references/` 為 STE100 繁體中文。中文並列項用頓號「、」，不用半形「/」；英文項目的並列（CLI 名、頁名前綴）可用「/」。 @@ -144,4 +144,5 @@ - [ ] wiki repo 與 Gitea 認證先讀目前 shell 繼承的環境變數；只有缺值或無法解析時才詢問；頁面類型不得跨用其他 `JSC_WIKI_REPO_{TYPE}` - [ ] 問詢透過 jsc-ask 決策樹規則 - [ ] SKILL.md 整份為英文（要原樣輸出的繁中字面除外）；README、AGENTS、templates、references 為 STE100 繁中；UTF-8 無亂碼 +- [ ] 所有非程式碼輸出（程式碼註解、commit 訊息、PR 描述、wiki 頁、回報、文件）為繁體中文、UTF-8、無亂碼、無簡體字，且 `tools/ste100-lint.sh` 對該 domain 全綠 - [ ] 已同步更新該 domain 的 README「Skills 目錄」與三份 manifest 的 version diff --git a/references/ste100.md b/references/ste100.md index ee857db..6143142 100644 --- a/references/ste100.md +++ b/references/ste100.md @@ -4,11 +4,36 @@ jsc 技能組所有交談與文件的語言規則，唯一來源在這裡。基 上游版本：speak-human-tw v1.4.0（2026-07-18）。上游有新版時用 `jsc-meta:ste100-sync` 同步。 +## 適用範圍 + +**所有非程式碼輸出一律適用**。程式碼本身不受限。 + +| 對象 | 適用 | 說明 | +| :-- | :-- | :-- | +| 程式碼註解 | 是 | 含檔頭說明與行內註解 | +| commit 訊息 | 是 | 標題與內文；type 與 scope 仍為英文 | +| PR 描述 | 是 | 標題、各節內文 | +| wiki 頁內容 | 是 | 頁名前綴與範本欄位名維持英文 | +| 對使用者的回報 | 是 | 交談、進度回報、錯誤說明 | +| README、AGENTS.md | 是 | | +| `references/`、`templates/` | 是 | | +| 程式碼識別字、關鍵字、API 名稱 | 否 | 變數、函式、型別、參數、指令、路徑、URL | +| SKILL.md | 否 | 整份英文，規則見 `guidelines.md`「語言」 | + ## 基礎紀律 1. 短句，一句一指令，主動語態。 2. 同一個概念全程用同一個詞，不換詞循環。 -3. UTF-8，無亂碼。 + +## 編碼 + +| 要求 | 內容 | 常見違規 | +| :-- | :-- | :-- | +| UTF-8 | 檔案一律 UTF-8（無 BOM） | Big5、GBK 存檔 | +| 無亂碼 | 不得出現替代字元或雙重編碼殘留 | `�`、`�`、`ä`、`â` 開頭的三字元序列 | +| 無簡體字 | 一律繁體字形 | 应、这、说、国、网、码 | + +亂碼多半來自轉檔或複製貼上，肉眼容易漏掉，交給 `tools/ste100-lint.sh` 的「亂碼」類別擋。 ## 台灣用語 @@ -63,4 +88,4 @@ jsc 技能組所有交談與文件的語言規則，唯一來源在這裡。基 ## 機檢 -可機檢的部分（中國用語、中文句內半形標點、AI 套話）用 `tools/ste100-lint.sh ` 檢查，命中 exit 1。掃描時跳過本檔（規則文件裡的詞是被討論，不是被使用）；語感與翻譯腔仍要人工判讀。 +可機檢的部分（中國用語、中文句內半形標點、AI 套話、簡體字、亂碼、並列斜線）用 `tools/ste100-lint.sh ` 檢查，命中 exit 1。`.md` 與 `.json` 跑全部類別；程式碼檔只跑簡體字與亂碼，其餘類別對英文標點與路徑誤報率太高。掃描時跳過本檔（規則文件裡的詞是被討論，不是被使用）；語感與翻譯腔仍要人工判讀。