plugins/meta
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(ste100): 語言規則納入適用範圍與編碼要求

Browse Source 
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` 的人要照新清單檢查。
This commit is contained in:
jiantw83
2026-08-27 09:43:20 +08:00
parent 444ab9762b
commit 19303ca555
2 changed files with 29 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
references/guidelines.md
+2 -1
View File
@@ -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：短句、祈使句、術語一致。 2. **技能文件（SKILL.md）整份為英文**：frontmatter 與內文都是。風格比照 STE100：短句、祈使句、術語一致。
3. 技能文件裡「要原樣輸出的繁中字面內容」保留繁中：wiki 狀態字串（例：已分析、未完成）、hook 注入文字、要寫進 wiki 或 commit 的文案。技能執行時產生的 commit 訊息、PR 描述、wiki 頁內容仍依第 1 條輸出繁中。 3. 技能文件裡「要原樣輸出的繁中字面內容」保留繁中：wiki 狀態字串（例：已分析、未完成）、hook 注入文字、要寫進 wiki 或 commit 的文案。技能執行時產生的 commit 訊息、PR 描述、wiki 頁內容仍依第 1 條輸出繁中。
4. README、AGENTS.md、`templates/`、`references/` 為 STE100 繁體中文。中文並列項用頓號「、」，不用半形「/」；英文項目的並列（CLI 名、頁名前綴）可用「/」。 4. README、AGENTS.md、`templates/`、`references/` 為 STE100 繁體中文。中文並列項用頓號「、」，不用半形「/」；英文項目的並列（CLI 名、頁名前綴）可用「/」。
@@ -144,4 +144,5 @@
- [ ] wiki repo 與 Gitea 認證先讀目前 shell 繼承的環境變數；只有缺值或無法解析時才詢問；頁面類型不得跨用其他 `JSC_WIKI_REPO_{TYPE}` - [ ] wiki repo 與 Gitea 認證先讀目前 shell 繼承的環境變數；只有缺值或無法解析時才詢問；頁面類型不得跨用其他 `JSC_WIKI_REPO_{TYPE}`
- [ ] 問詢透過 jsc-ask 決策樹規則 - [ ] 問詢透過 jsc-ask 決策樹規則
- [ ] SKILL.md 整份為英文（要原樣輸出的繁中字面除外）；README、AGENTS、templates、references 為 STE100 繁中；UTF-8 無亂碼 - [ ] SKILL.md 整份為英文（要原樣輸出的繁中字面除外）；README、AGENTS、templates、references 為 STE100 繁中；UTF-8 無亂碼
- [ ] 所有非程式碼輸出（程式碼註解、commit 訊息、PR 描述、wiki 頁、回報、文件）為繁體中文、UTF-8、無亂碼、無簡體字，且 `tools/ste100-lint.sh` 對該 domain 全綠
- [ ] 已同步更新該 domain 的 README「Skills 目錄」與三份 manifest 的 version - [ ] 已同步更新該 domain 的 README「Skills 目錄」與三份 manifest 的 version
references/ste100.md
+27 -2
View File
@@ -4,11 +4,36 @@ jsc 技能組所有交談與文件的語言規則，唯一來源在這裡。基
上游版本：speak-human-tw v1.4.0（2026-07-18）。上游有新版時用 `jsc-meta:ste100-sync` 同步。 上游版本：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. 短句，一句一指令，主動語態。 1. 短句，一句一指令，主動語態。
2. 同一個概念全程用同一個詞，不換詞循環。 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 <file|dir>` 檢查，命中 exit 1。掃描時跳過本檔（規則文件裡的詞是被討論，不是被使用）；語感與翻譯腔仍要人工判讀。 可機檢的部分（中國用語、中文句內半形標點、AI 套話、簡體字、亂碼、並列斜線）用 `tools/ste100-lint.sh <file|dir>` 檢查，命中 exit 1。`.md` 與 `.json` 跑全部類別；程式碼檔只跑簡體字與亂碼，其餘類別對英文標點與路徑誤報率太高。掃描時跳過本檔（規則文件裡的詞是被討論，不是被使用）；語感與翻譯腔仍要人工判讀。