tw-writing skillA
tw-writing is agent-read markdown (skill) from kirinlin/tw-writing: 繁體中文（台灣）清晰、精確、簡潔的寫作規範。撰寫、改寫、審查、潤稿或翻譯 繁體中文內容時使用。涵蓋技術文件、軟體文件、README、設計文件、規格書、SOW、 工程報告、錯誤訊息、commit message，以及 AI Agent 產生的繁體中文內容。 包含台灣用語與中國用語對照、中英文混排、標點、數字格式、AI 腔調反模式 及最終檢查清單。以 The Elements of Style 的寫作原則為基礎，針對繁體中文語法、 資訊結構與技術寫作進行本地化。.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 繁體中文寫作版 The Elements of Style ## 1. 目的與適用範圍 ### 1.1 目的 本 Skill 用於產生、修改、審查繁體中文文字，使內容具備： 1. **清楚（Clarity）** 2. **精確（Precision）** 3. **簡潔（Concision）** 4. **一致（Consistency）** 5. **自然（Naturalness）** 核心原則： > **清楚優先於簡潔，簡潔優先於華麗。** 不要為了「短」而刪除必要資訊，也不要為了「正式」而增加沒有資訊價值的文字。 本 Skill 是繁體中文寫作規範，**不是英文文法規則的逐條翻譯**。 ### 1.2 適用文件 - 技術文件、軟體文件、API 文件 - README、設計文件、架構文件 - 規格書、SOW、工程報告 - 操作手冊、疑難排解文件 - 錯誤訊息、日誌訊息、UI 文字 - commit message、PR 描述、程式碼註解 - AI Agent 產生或編輯的繁體中文內容 ### 1.3 不適用或需調整的情況 以下情況不套用本 Skill，或套用前需先確認： - **法律契約與法規文字**：用字受法律效力約束，不得為求簡潔改寫。 - **行銷文案**：目的是說服而非說明，容許本 Skill 限制的修辭。 - **引用他人文字**：引用時保留原貌，不改寫。 - **既有格式規範**：政府公文、學術期刊、特定標準（如 ISO 文件範本）有自己的格式要求時，優先遵循該規範。 - **既有專案風格指南**：專案若已有風格指南，以該指南優先；本 Skill 補充未涵蓋的部分。 判斷原則： > **本 Skill 服務於「讓讀者正確理解」。當其他要求優先於此目標時，本 Skill 讓步。** ### 1.4 本 Skill 的檔案 | 檔案 | 內容 | 何時讀取 | |---|---|---| | `SKILL.md` | 完整規範 | 一律適用 | | `references/taiwan-terms.md` | 台灣用語與中國用語完整對照表 | 需要查詢個別術語，或審查疑似中國用語時 | `references/taiwan-terms.md` 是 Agent 語意判斷用的查表資料。若執行環境另外提供 [`zhtw-mcp`](https://github.com/sysprog21/zhtw-mcp) MCP 工具，該工具以規則庫做機械檢查，兩者互補而非重複；見 §25「外部工具（若可用）」。 --- ## 2. 結構原則 ### 2.1 一段一主題 一個段落應主要處理一個完整的主題、論點或步驟。 避免： - 同一段同時討論多個不相關問題。 - 在段落中途突然改變主題。 …
Read the whole file at its exact version.
How to install
mdr add kirinlin/tw-writing/tw-writing@git:20260913.b672ccamdr add kirinlin/tw-writing/tw-writing@sha256:712543f0a7db87f6Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_u4pmq3uiu27y2uzs)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260913.b672cca latest | 2026-09-13 | b672cca | 47,624 B | A | view · diff |
| git:20260913.e04bbba | 2026-09-13 | e04bbba | 47,615 B | A | view · diff |
| git:20260913.627080e | 2026-09-13 | 627080e | 47,633 B | A | view · diff |
| git:20260912.9fa620b | 2026-09-12 | 9fa620b | 47,687 B | A | view · diff |
| git:20260912.da340f8 | 2026-09-12 | da340f8 | 47,643 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (47624 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
kirinlin/tw-writing · 17 stars · license MIT · pushed 2026-09-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_u4pmq3uiu27y2uzs GET https://markdownregistry.com/api/v1/resolve?ref=kirinlin/tw-writing/tw-writing GET https://markdownregistry.com/api/v1/blob/712543f0a7db87f64f1e28c681bbc9cc11afd2de278dedda6eacb4c9663e6724
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.