ste-zh 是規定 Agent 回覆寫法的 skill，將 ASD-STE100 的寫作原則改寫為中文規則。啟用後，回覆先寫結論，再提供固定狀態詞與驗證證據；程式碼及寫入專案的檔案仍依專案規範撰寫。
ste-zh 用於整理 Agent 寫給使用者的結果。規則要求一詞一義、一句一事，並將工作是否完成與是否驗證分開標示。它依靠 Agent 遵守上下文中的指令生效，沒有程式強制執行。
ASD-STE100 是簡化技術英語（Simplified Technical English）的技術文件標準。依 README 說明，該標準針對英文；ste-zh 自訂中文規則及編號，未包含標準原文或詞典，且與 ASD、STE 維護組沒有關聯。
| 內容 | 規範 |
|---|---|
| 任務結果、進度與排查結論 | 依 ste-zh 的回覆模板撰寫。 |
| 請使用者決定或確認的問題 | 列出編號選項，說明動作及後果。 |
| 多項工作、任務卡與 issue 總結 | 分列共同條件、問題、要做與待確認事項。 |
| 程式碼、註解、commit message 與專案檔案 | 依專案規範撰寫。 |
| 原樣引用的日誌、錯誤與命令輸出 | 保留原文，不改寫字面內容。 |
來源：README.md； SKILL.md 的適用範圍。
將整個儲存庫放入 Agent 的 skill 目錄。安裝目錄必須命名為 ste；儲存庫名稱 ste-zh 與安裝目錄名稱不同。
在終端機執行 README 提供的 Claude Code 全域安裝命令：
在 Agent 對話中輸入 /ste。生效時，Agent 必須讀取 references/terminology.md 第 2–5 節。
| 用途 | 輸入與結果 |
|---|---|
| 啟用 | /ste；README 另列出「用 STE 規範輸出」與「按 ASD-STE100 匯報」兩種觸發語句，此處已轉為繁體。 |
| 確認啟用 | 第一條回覆用一句話說明後續輸出按 ASD-STE100 原則撰寫。 |
| 維持 | 本會話中每條回覆持續遵守規則，直到使用者停止。 |
| 停止 | 輸入「停止 ste」或 stop ste，恢復預設寫法。 |
| 重新載入 | 長會話或上下文壓縮後失去規則時，再輸入 /ste。 |
SKILL.md 的 Agent 依各自文件放置整個 ste 目錄。不要套用未記載的主機參數或安裝腳本。
SKILL.md 定義 25 條規則與 5 種模板。以下卡片是回覆格式，沒有各自的斜線指令；啟用入口仍為 /ste。
下表保留上游 R1–R25 編號，將規則摘要轉為繁體。這些編號由本 skill 自訂。
| 編號 | 規則 | 檢查方式 |
|---|---|---|
| R1 | 一詞一義 | 同一意思在全文使用同一詞。 |
| R2 | 先定義，後使用 | 專用詞在術語節定義；僅一兩個時可在首次出現處定義。 |
| R3 | 具體動詞 | 直接寫「修改設定」，不將動作包裝成名詞。 |
| R4 | 字面量原樣保留 | 介面文案、命令、路徑與識別符保持原文。 |
| R5 | 名詞串上限 | 連續名詞不超過 3 個。 |
| R6 | 一句一事 | 每句只含一個動作或事實。 |
| R7 | 句長上限 | 中文步驟句不超過 30 字，描述句不超過 40 字。漢字各計 1 字；英文單字、數字或程式碼識別符各計 1 字，標點不計。 |
| R8 | 主動語態 | 寫出動作執行者；執行者不明或不重要時才用被動句。 |
| R9 | 條件在前 | 先寫條件，再寫動作。 |
| R10 | 不用雙重否定 | 直接寫出要求。 |
| R11 | 固定情態詞 | 要求、禁止與允許使用「必須」「不得」「可以」。 |
| R12 | 明確主詞 | 省略主詞會有歧義時，補出主詞。 |
| R13 | 一段一主題 | 每段不超過 6 句。 |
| R14 | 編號步驟 | 步驟使用祈使句，每步一個動作，結果另寫一句。 |
| R15 | 列表代替長句 | 3 個以上並列項使用列表。 |
| R16 | 警告先寫命令 | 先寫必須做或不得做的事，再寫不遵守的後果。 |
| R17 | 完整列舉 | 列出完整清單或其位置，不用「等」「之類」結尾。 |
| R18 | 結論先行 | 回覆第一句寫結果。 |
| R19 | 固定狀態詞 | 工作狀態僅使用術語表定義的 10 個詞。 |
| R20 | 如實標示驗證 | 每個結論附驗證狀態與方法；失敗檢查附失敗輸出。 |
| R21 | 不敘述過程 | 保留結果與必要證據，刪除執行順序敘事。 |
| R22 | 可定位證據 | 引用程式碼附路徑與行號；引用提交附 SHA；命令寫完整。 |
| R23 | 編號選項 | 推薦選項放第一並標註「推薦」，各項附動作與後果。 |
| R24 | 標明未確認 | 未核實事實寫「未確認」與確認方法。 |
| R25 | 來源中的事實 | 不補入來源沒有的內容；缺少內容列為待確認。 |
| 情境 | 格式 |
|---|---|
| 尚在執行工作 | 進度說明。 |
| 回報改動與檢查 | 結果匯報；有排查內容時，合併原因與證據。 |
| 解釋錯誤原因 | 排查結論；未核實時標明原因未確認。 |
| 由使用者選擇下一步 | 請求決定；一個待確認事項下列編號選項。 |
| 整理多張任務卡或多項變更 | 多項總結；保留來源的標題、規模與類型。 |
以下原則來自官方規則與術語表。依固定詞義檢查回覆，並將缺少的事實列入待確認。
Agent 生效時必須讀取術語表第 2–5 節。表中沒有的專用詞，在回覆的術語節固定寫法。
來源 · SKILL.md 生效與持續；terminology.md 開頭「必須」表示強制要求；「不得」表示禁止；「可以」表示允許。術語表僅限制情態用法，表示依賴的「需要」與固定欄名「要做」不受此限。
來源 · terminology.md 第 2 節「已完成」表示動作完成且結果符合要求。「已驗證」表示已執行檢查且通過，必須附檢查方法；未檢查時標明「未驗證」。
來源 · terminology.md 第 4 節程式碼證據附檔案路徑與行號。命令寫完整，提交寫 SHA；沒有核實的事實附確認方法。
來源 · SKILL.md R22、R24使用「修改設定」描述動作。依模板保留「改動」「驗證」「待確認」欄名；沒有內容的節刪除。
來源 · SKILL.md R3、輸出模板；terminology.md 第 3、5 節「問題」記錄現狀，「要做」記錄可檢查的結果。來源沒有列出的次數、行為或清單，列為待確認。
來源 · SKILL.md 多項總結；examples/task-summary.md| 狀態 | 定義與附帶資訊 |
|---|---|
| 已完成 | 動作全部執行，結果符合要求；此詞不單獨代表已驗證。 |
| 部分完成 | 僅執行一部分，列出尚未執行的部分。 |
| 未開始 | 尚未執行任何動作。 |
| 進行中 | 動作已開始，尚未結束。 |
| 已驗證 | 已執行檢查且通過，附檢查方法。 |
| 未驗證 | 沒有執行檢查，附原因。 |
| 失敗 | 動作或檢查不符合要求，附失敗輸出。 |
| 跳過 | 有意不執行，附原因。 |
| 阻塞 | 缺少條件而無法繼續，附缺少的條件。 |
| 未確認 | 事實尚未核實，附核實方法。 |
來源：references/terminology.md； SKILL.md； examples/task-summary.md。
以下是依 examples/result-report.md 整理的示意對話。上游將案例來源標為虛構；本手冊未實際執行登入修復或測試。檔案路徑、行號與測試數字均取自案例的「Agent 掌握的事實」。
案例要求修復登入後偶發退出。Agent 同時刪除原範圍外的重複日誌，因此回覆必須揭露該改動，並列出保留或撤回的選項。
| 項目 | 範例中的證據 |
|---|---|
| 首句結論 | 登入問題的完成狀態與 iOS 未驗證狀態。 |
| 原因定位 | auth/refresh.ts:42 的刷新前檢查缺口。 |
| 驗證來源 | npm test auth 與 auth/refresh.test.ts:88 均在上游已知事實清單中。 |
| 範圍揭露 | 日誌刪除屬原範圍外改動，另列使用者決定。 |
| 缺少證據 | 沒有 iOS 建置環境，因此保留未驗證狀態。 |
實際匯報時，將範例內容替換為該次任務的事實與工具輸出。沒有執行測試時，使用「未驗證」並附原因，不沿用案例的通過數字。
/ste。
依 README 的常駐載入方式設定會話，再用 SKILL.md 的自檢清單逐條檢查回覆。
/ste，確認 Agent 說明後續回覆採用規則；輸入 stop ste 可停止。~/.claude/CLAUDE.md，或 ~/.claude/rules/ 下的規則檔案。/ste。| 檔案 | 閱讀目的 |
|---|---|
| SKILL.md | 生效範圍、25 條規則、5 種模板與自檢清單。 |
| references/terminology.md | 固定譯法、情態詞、狀態詞與模板欄名。 |
| examples/result-report.md | 結果、原因、證據與範圍外改動的合併匯報。 |
examples/task-summary.md 示範如何整理 3 張虛構任務卡。範例保留原標題、規模與類型，將來源未列出的機型清單、重試失敗行為及提示內容列入待確認。