Home / kirinlin / tw-writing · GitHub

tw-writing SKILL.md skillA

tw-writing from kirinlin/tw-writing is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kirinlin/tw-writing/tw-writing@git:20261107.4aca44f

Pins git:20261107.4aca44f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kirinlin/tw-writing
Path
SKILL.md
Versions recorded
7
Latest version
git:20261107.4aca44f, committed Nov 7, 2026
First version recorded
Sep 12, 2026
Size
36,014 bytes
Repository stars
17
License
MIT

撰寫、改寫、審查、潤稿或翻譯台灣繁體中文內容時使用，尤其適用於技術文件、 README、規格書、操作說明、錯誤訊息與 PR 描述。改善結構、語意、台灣用語、 中英文混排與標點，同時保留原文事實、技術識別名稱及規範強度。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 台灣繁體中文寫作規範

## 1. 目的與適用範圍

### 1.1 目的

讓讀者正確理解內容，並知道需要採取的行動。寫作以清楚、精確、簡潔、一致、自然為目標；規則衝突時依 §27 判斷。

開始前先確認任務是撰寫、改寫、翻譯或審查，再確認讀者、用途與需要保留的內容。已有足夠資訊就直接處理；只有影響語意或交付範圍的缺漏才需要詢問。

### 1.2 適用文件

適用於繁體中文說明、技術文件、README、設計文件、規格書、SOW、工程報告、操作手冊、UI 文字、錯誤訊息、commit message、PR 描述與程式碼註解。

只處理任務指定的文字與必要的上下文。套用寫作規範不代表取得修改程式、重命名檔案、變更設定或發佈內容的授權。

### 1.3 適用限制與例外

- 使用者要求與既有專案風格指南優先；本 Skill 補充未涵蓋的部分。
- 法律契約、法規與標準文字保留規範強度及正式用字，不為文風改變效力。
- 引文、官方名稱、產品 UI 標籤、識別名稱與待分析的原文保留原貌；需要解釋時另寫說明。
- 行銷、文學與對話內容依用途調整語氣，不機械套用技術文件的修辭限制。
- 使用者只要求審查時，回報問題與建議，不直接改寫檔案。

### 1.4 本 Skill 的檔案

| 檔案 | 用途 | 何時讀取 |
|---|---|---|
| `SKILL.md` | 核心規範、流程與檢查清單 | 套用本 Skill 時 |
| [references/taiwan-terms.md](references/taiwan-terms.md) | 依領域分類的用語對照 | 查詢術語或審查疑似中國用語時 |

先依語意選詞，再查表。環境提供 `zhtw-mcp` 時，可用其機械檢查補充人工判斷，見 §25。工具不是本 Skill 的必要條件。

---

## 2. 結構原則

### 2.1 一段一主題

一段處理一個主要論點，讓理由、例子與限制支持該論點。主題改變就換段；不必把每句都拆成獨立段落。

### 2.2 段首先說重點

一般說明先寫結論或行動，再補原因與細節。讀者需要背景才能理解結論時，先給最少的必要背景。

Before：

> 由於不同部署環境的網路連線與服務啟動流程不同，因此設定時需要注意環境差異。

After：

> 不同部署環境需要不同的服務啟動設定，因為各環境的網路連線與啟動流程不同。

### 2.3 一句一主要意念

拆開含有多個轉折或條件的長句，保留因果與時間關係。簡單的連續動作可留在同一句。

Before：

> 系統啟動後讀取設定檔並連線，如果連線失敗會重試，超過重試上限會記錄錯誤並停止服務。

After：
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kirinlin/tw-writing/tw-writing@sha256:858bd50cbabf4b9b

The line at the top of this page pins the label git:20261107.4aca44f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_u4pmq3uiu27y2uzs.svg)](https://markdownregistry.com/a/art_u4pmq3uiu27y2uzs)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Sep 12, 2026 and Nov 7, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261107.4aca44f latest2026-11-07 4aca44f 36,014 BA view · diff
git:20261007.d5fd7862026-10-07 d5fd786 35,300 BA view · diff
git:20260913.b672cca2026-09-13 b672cca 47,624 BA view · diff
git:20260913.e04bbba2026-09-13 e04bbba 47,615 BA view · diff
git:20260913.627080e2026-09-13 627080e 47,633 BA view · diff
git:20260912.9fa620b2026-09-12 9fa620b 47,687 BA view · diff
git:20260912.da340f82026-09-12 da340f8 47,643 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (36014 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

GitHub

kirinlin/tw-writing · 17 stars · license MIT · pushed 2026-11-07 · 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/858bd50cbabf4b9b461df7ebef7a4d284fe425fd11bf27c785fd13884f458eaa

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kirinlin/tw-writing

AGENTS.md AGENTS.md file
kirinlin/tw-writing · AGENTS.md
git:20260919.e8302a4 · audit A · 17 stars
CLAUDE.md CLAUDE.md file
kirinlin/tw-writing · CLAUDE.md
git:20260919.e8302a4 · audit A · 17 stars

Every file in kirinlin/tw-writing

Browse by kind, by grade A, or by owner.