taiwan-traditional-chinese について
taiwan-traditional-chineseは、台湾で使われる繁体字中国語の文章作成スキルです。地域固有の用語やソフトウェア用語を定め、技術文書や散文の語彙、文体、書式を確認する手順を備えています。
主な機能
- 01台湾の繁体字中国語を使用
- 02地域固有のソフトウェア用語を標準化
- 03散文と技術文書の規則を提示
- 04用語集とスクリプトによる語彙確認
- 05書式とAIらしい文体の確認
活用シーン
- 01台湾の繁体字中国語でプロジェクト文書を作成
- 02READMEや仕様書、リリースノートを推敲
- 03ソフトウェア用語の地域的な用法を確認
- 04中国語テキストの文体と書式を点検
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ lanamaysu/ agent-skills --skill taiwan-traditional-chineseインストール後、Claude Code で/taiwan-traditional-chineseを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEREADME.mdreferences/guidelines.mdprose-style.mdREADME.mdterms.csvscripts/audit_shared_glyphs.pyfetch_terms.pylint_zhtw.pyrequirements.txttest_lint_zhtw.py詳細
台湾繁体字中国語レスポンススキル
概要
- 台湾で使われる用語を必ず使用してください:元件、非同期、資料、サーバー、データベース、キャッシュ。フレームワークとコードは英語のままにします。
- 絶対に使用しない用語:組件/组件、異步/异步、數據/数据、服務器/服务器、函數/函数、數組/数组、加載、依賴。
- 見つけたらすぐ削除:「值得注意的是」「事實上」「總的來說」「賦能」「深入探討」「打造」「至關重要」「進行 + 動詞」。
必須行う事前確認
このファイルにある4つの表は常に有効です。references はデフォルトでは読みません。
- 散文スタイル.md:連続した散文を書く場合にのみ読みます(プロジェクト文書、README の説明文、ADR、リリースノート、仕様書、プレゼンテーション、またはユーザーから「AIっぽすぎる」「文章を整えて」と言われた場合)。読む場合は、書き始める前に読んでください。書き終えてから確認するのではありません。段落構成ができてしまうと、後から変更するのは難しく、事後確認で直せるのは語彙だけです。モデルに順序を任せたところ、このファイルを最後に読む手順に回し、3本の文章の骨格はすでにできあがっていました。コミットメッセージ、コードコメント、テストケースの説明、表、API パラメーターの説明では読まないでください。固定形式に散文のリズムを当てはめると崩れてしまいます。このファイルの「AIっぽさクイックチェック」だけで十分です。
- このファイルの見た目をそのまま真似しないでください。このファイルは参照しやすいように太字や表を多用していますが、これはクイックリファレンスの形式であり、出力する文章の形式ではありません。散文は散文として書いてください。疑似見出し(独立した行に置く
**……**)は明確に禁止されています。下記「AIっぽさクイックチェック」の第4項を参照してください。 - guidelines.md:品質チェックに合格しなかった場合、またはユーザーから監査を求められた場合にのみ読みます。
- terms.csv:中国語を出力するたびに必ず確認してください。これは必須手順です。手順は下記「品質チェックと書き直しのフロー」の第2ステップを参照してください。必ず
grepを使い、ファイル全体は読まないでください。2,122件の用語があり、全体を読むと4万トークン以上になります。grepなら数行だけ返されます。
基本ルール
- 繁体字中国語(zh-Hant-TW/zh-TW/zh_TW)を使用し、台湾で一般的な表現を使います。
- ユーザーが「中国語で/中国語で回答/中国語で出力」と言った場合、明示的に簡体字(簡体/简体/zh-Hans/简中)を指定していない限り、繁体字中国語として扱います。
- 用語は台湾での慣例に従います(資料、元件、應用程式、資料庫、伺服器)。
- フレームワーク名、API、コードの記号、ファイルパスは英語のままにします。
- ファイルパスはリンクにせず、そのままバッククォートで囲みます。
- 中国語の文には全角句読点を使い、コードとパスには半角句読点を使います。
重要用語のクイックリファレンス(必ず遵守)
絶対に使用しない用語:代碼/代码、组件、異步/异步、回退、變量/变量、映射、對象/对象、數組/数组、函數/函数、返回值、導入/导入、導出/导出、依賴/依赖、數據/数据、應用程序/应用程序、數據庫/数据库、服務器/服务器、緩存/缓存、網絡/网络、加載、模塊、線程
必ず使用する台湾用語:component 元件、array 陣列、object 物件、function 函式、data 資料、variable 變數、parameter 參數、return value 回傳值、import 匯入、export 匯出、async 非同步、cache 快取、load 載入、server 伺服器、database 資料庫、network 網路、thread 執行緒、module 模組、package 套件、dependency 相依性
中国ソフトウェア業界のスラング禁止リスト(すべてのタスクに適用)
これらの語は中国で使われる表現であり、中身のない言い回しでもあります。具体的な動詞に置き換えると、何をしたのかを明確に述べる必要が生じます。プロジェクト文書、PR の説明、議事録を書くときに特に紛れ込みやすい表現です。
| 禁止表現 | 代替表現 |
|---|---|
| 落地 | 實作、實現、上線 |
| 復盤 | 檢討、回顧 |
| 沉澱(抽象物) | 累積、整理留存 |
| 閉環 | 完整流程;「形成閉環」→ 把流程走完 |
| 抓手 | 著力點、切入點 |
| 打通 | 整合、串接 |
| 顆粒度 | 細緻程度(技術文件中的 granularity は「粒度」を使用可) |
| 賽道 | 領域、市場 |
| 頭部(=領先者) | 龍頭、頂尖 |
| 痛點 | 台湾のビジネス用語として定着しています。正式な文書では「問題所在」「癥結」に置き換えます |
多義語:語義を見て判断し、一律に禁止しない
これらの語は台湾でも使われますが、意味が異なる場合があります。語義に応じて判断してください。下表は特に間違いやすい例です。それ以外の語は terms.csv を調べてください。clues/avoid_clues/note の3列に判断条件が記載されています。
| 語 | 台湾で使う語義 | この語義の場合の置き換え |
|---|---|---|
| 質量 | 物理学の mass | quality → 品質 |
| 水平 | horizontal | 標準、程度 → 水準 |
| 通過 | pass(通過考試、通過審查) | 手段を表す場合 → 透過 / 藉由 |
| 項目 | item(清単の項目) | project → 專案 |
| 對齊 | レイアウトやデータ構造の位置合わせ | 会議での「對齊」→ 同步、取得共識 |
| 數據 | 数値統計 | data の総称 → 資料 |
| 文件 | document | file → 檔案 |
| 並行 | concurrency | parallelism → 平行(中国語の「並行」は parallel を指すため、そのまま使うと意味が逆になります) |
| 進程 | 進捗、進展 | OS process → 行程 |
| 渲染 | 誇張すること、中国画のぼかし技法 | rendering → 算繪 |
| 遍歷 | 遍歷理論(Ergodic theory) | traverse → 走訪 |
字形は判断に影響しません。「數據」「組件」「落地」を繁体字で書いても、依然として中国で使われる用語です。繁体字と簡体字は字形の違いであり、用語は地域によって異なります。上記の3つの表にある表現は、どちらの字形であっても置き換えてください。(terms.csv の検索方法は guidelines.md を参照)
AIっぽさクイックチェック(すべてのタスクに適用)
用語が正しくても、文章を見ればAIが書いたとすぐにわかることがあります。用語の誤りは同僚に指摘されますが、AIっぽさは誰も指摘しません。ただ、文書を読みたくなくなるだけです。
見つけたらすぐ削除(削除しても意味が損なわれないため、迷わず削除):值得注意的是、需要注意的是、值得一提的是、更重要的是、事實上、毫無疑問、可以說、簡單來說、總的來說、綜上所述;見出し風の定型句「一句話:」「核心理念:」「關鍵:」「以下是」。
見つけたらすぐ置き換え:
| 禁止表現 | 代替表現 |
|---|---|
| 賦能 | 讓⋯⋯能夠、給⋯⋯工具 |
| 深入探討 | 討論、分析、細看 |
| 揭示了 | 顯示、說明、指出 |
| 打造 | 做、建立、寫 |
| 旨在 | 為了、目的是 |
| 至關重要 / 不可或缺 | 重要、關鍵、必要(いずれか1つを選び、重ねて使わない) |
| 進行 + 動詞 | 動詞をそのまま使う(「進行分析」→「分析」) |
| 在⋯⋯的過程中 / 在⋯⋯方面 | 枠を取り除いて要点を残す(「在重構的過程中」→「重構時」) |
4つの数値上限:
- ダッシュ(——)は1,000字あたり最大1組です。読点や句点に置き換えても意味が変わらない場合は、置き換えてください。
- 「不是 X,而是 Y」は1,000字あたり最大1回とし、藁人形論法のテストを通す必要があります。本当に X を信じる人がいるでしょうか。いないなら、Y をそのまま述べてください。
- 3項目を並べた表現(更 A、更 B、更 C):3項目が互いに導き出せるなら、1項目に絞ってください。
- 太字は段落ごとに最大1箇所とし、文全体を太字にすることは禁止です。
書き出しと締めくくり:質問を言い換えないでください(「這是一個很好的問題」)。応答としての過剰な熱意も示さないでください(「當然可以!」)。展望を示す締めくくりも使わないでください(「希望這些資訊對你有幫助」)。内容を伝え終えたら、そこで止めてください。
冗長な「一個」:英語の冠詞の名残です。「一種」「一位」「一項」も同様です。削除しても文が成立するなら削除してください。
詳細なルール、例文、項目ごとのセルフチェック手順については prose-style.md を参照してください。連続した散文を書く場合にのみ読む必要があります。
品質檢查與重寫流程
速查表是給你第一次就寫對用的,不是事後對照用的。
-
產出前掃一遍上方四塊(絕對禁用、軟體圈行話、一詞多義、AI 味速查),照著寫。
-
查表。這步無條件執行,不看第 3 步的結果,而且候選詞不由你判斷。
下面的路徑都相對於本 skill 目錄,不是相對於專案根目錄。
能執行指令時,把草稿餵給腳本。用 stdin,不要另存暫存檔——存了就會忘記刪,skill 目錄裡會多出
draft_check.txt這種殘骸:cat <<'EOF' | python3 scripts/lint_zhtw.py --terms - (草稿全文) EOF已經是檔案就直接給路徑:
python3 scripts/lint_zhtw.py --terms draft.md。它逐列比對整份 terms.csv,不管你覺得哪個詞可疑。輸出格式是
行號: [用詞] 原詞 → 建議;標「(語境未確認)」表示該列有clues,要自己確認語境對不對再改。只能 grep 時,pattern 要從草稿機械地抽:把每個連續中文字串按 2 到 6 字切出來全部放進去,不是放你覺得可疑的那幾個。
grep -nE "候選1|候選2|候選3|…" references/terms.csvcn欄同時收簡體與繁體兩種字形,兩種都要試。有命中就照tw欄改。為什麼候選詞不能自己挑:直覺只挑得出你已經知道有問題的詞。實測讓模型自行「挑出可疑的詞」,它挑的是本來就認得的那幾個,真正查了才會的詞一個都沒進 pattern,等於沒查。你覺得沒問題的詞,才是最需要查的那些。
全篇一次餵完,不要逐段查、也不要每改一個詞就重跑一次。腳本一次讀整份草稿、一次列出所有命中列;命中清單看完一次全部改完,改完只需要照第 5 步再跑一次確認,不必每改一處就重新查一次。實測這樣拖到十幾次工具呼叫,慢,而且每一步都是可能斷掉的地方。
-
產出後自我檢查一次,以下任一項成立即為不通過:
- 出現「絕對禁用」或「中國軟體圈行話」表裡的詞
- 一詞多義的詞用錯義項
- 出現「AI 味速查」刪除清單或替換表裡的詞
- 破折號、假對比、三項式排比、加粗超過量化上限(含整句加粗)
- 開場復述問題,或收尾出現「希望這些資訊對你有幫助」
- 中文句子用了半形標點,或程式碼與檔名沒加反引號
- 英文專有名詞被翻譯掉(React、useState、API 要保留)
-
通過:直接輸出,不要開啟 guidelines.md。
-
未通過:讀 guidelines.md,重寫後再檢查一次。
-
只輸出通過的版本,不要提及檢查或查表過程。
Minimal Example
使用 React,在 `useEffect()` 中載入資料。
檔案位於 `src/components/Button.tsx`。
References
- prose-style.md:去 AI 味的完整行文規範(寫連續散文時讀)
- guidelines.md:完整指南(稽核時讀)
- terms.csv:術語對照表,由 scripts/fetch_terms.py 產生
- 外部來源(Wikibooks、zhtw-mcp、教育部辭典)列在 guidelines.md
- allenloves/de-ai-tone:CC BY-SA 4.0,
prose-style.md、軟體圈行話表、一詞多義表的來源
Last Updated: 2026-08-09