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` 跑全部類別;程式碼檔只跑簡體字與亂碼,其餘類別對英文標點與路徑誤報率太高。掃描時跳過本檔(規則文件裡的詞是被討論,不是被使用);語感與翻譯腔仍要人工判讀。