mcpField
T
taiwan-traditional-chinese

taiwan-traditional-chinese

github.com/lanamaysuその他157 回インストール
リポジトリ

taiwan-traditional-chinese について

taiwan-traditional-chineseは、台湾で使われる繁体字中国語の文章作成スキルです。地域固有の用語やソフトウェア用語を定め、技術文書や散文の語彙、文体、書式を確認する手順を備えています。

主な機能

  1. 01台湾の繁体字中国語を使用
  2. 02地域固有のソフトウェア用語を標準化
  3. 03散文と技術文書の規則を提示
  4. 04用語集とスクリプトによる語彙確認
  5. 05書式とAIらしい文体の確認

活用シーン

  1. 01台湾の繁体字中国語でプロジェクト文書を作成
  2. 02READMEや仕様書、リリースノートを推敲
  3. 03ソフトウェア用語の地域的な用法を確認
  4. 04中国語テキストの文体と書式を点検

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lanamaysu/agent-skills --skill taiwan-traditional-chinese

インストール後、Claude Code で/taiwan-traditional-chineseを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
README.md
references/
guidelines.md
prose-style.md
README.md
terms.csv
scripts/
audit_shared_glyphs.py
fetch_terms.py
lint_zhtw.py
requirements.txt
test_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列に判断条件が記載されています。

語台湾で使う語義この語義の場合の置き換え
質量物理学の massquality → 品質
水平horizontal標準、程度 → 水準
通過pass(通過考試、通過審查)手段を表す場合 → 透過 / 藉由
項目item(清単の項目)project → 專案
對齊レイアウトやデータ構造の位置合わせ会議での「對齊」→ 同步、取得共識
數據数値統計data の総称 → 資料
文件documentfile → 檔案
並行concurrencyparallelism → 平行(中国語の「並行」は parallel を指すため、そのまま使うと意味が逆になります)
進程進捗、進展OS process → 行程
渲染誇張すること、中国画のぼかし技法rendering → 算繪
遍歷遍歷理論(Ergodic theory)traverse → 走訪

字形は判断に影響しません。「數據」「組件」「落地」を繁体字で書いても、依然として中国で使われる用語です。繁体字と簡体字は字形の違いであり、用語は地域によって異なります。上記の3つの表にある表現は、どちらの字形であっても置き換えてください。(terms.csv の検索方法は guidelines.md を参照)

AIっぽさクイックチェック(すべてのタスクに適用)

用語が正しくても、文章を見ればAIが書いたとすぐにわかることがあります。用語の誤りは同僚に指摘されますが、AIっぽさは誰も指摘しません。ただ、文書を読みたくなくなるだけです。

見つけたらすぐ削除(削除しても意味が損なわれないため、迷わず削除):值得注意的是、需要注意的是、值得一提的是、更重要的是、事實上、毫無疑問、可以說、簡單來說、總的來說、綜上所述;見出し風の定型句「一句話:」「核心理念:」「關鍵:」「以下是」。

見つけたらすぐ置き換え:

禁止表現代替表現
賦能讓⋯⋯能夠、給⋯⋯工具
深入探討討論、分析、細看
揭示了顯示、說明、指出
打造做、建立、寫
旨在為了、目的是
至關重要 / 不可或缺重要、關鍵、必要(いずれか1つを選び、重ねて使わない)
進行 + 動詞動詞をそのまま使う(「進行分析」→「分析」)
在⋯⋯的過程中 / 在⋯⋯方面枠を取り除いて要点を残す(「在重構的過程中」→「重構時」)

4つの数値上限:

  1. ダッシュ(——)は1,000字あたり最大1組です。読点や句点に置き換えても意味が変わらない場合は、置き換えてください。
  2. 「不是 X,而是 Y」は1,000字あたり最大1回とし、藁人形論法のテストを通す必要があります。本当に X を信じる人がいるでしょうか。いないなら、Y をそのまま述べてください。
  3. 3項目を並べた表現(更 A、更 B、更 C):3項目が互いに導き出せるなら、1項目に絞ってください。
  4. 太字は段落ごとに最大1箇所とし、文全体を太字にすることは禁止です。

書き出しと締めくくり:質問を言い換えないでください(「這是一個很好的問題」)。応答としての過剰な熱意も示さないでください(「當然可以!」)。展望を示す締めくくりも使わないでください(「希望這些資訊對你有幫助」)。内容を伝え終えたら、そこで止めてください。

冗長な「一個」:英語の冠詞の名残です。「一種」「一位」「一項」も同様です。削除しても文が成立するなら削除してください。

詳細なルール、例文、項目ごとのセルフチェック手順については prose-style.md を参照してください。連続した散文を書く場合にのみ読む必要があります。

品質檢查與重寫流程

速查表是給你第一次就寫對用的,不是事後對照用的。

  1. 產出前掃一遍上方四塊(絕對禁用、軟體圈行話、一詞多義、AI 味速查),照著寫。

  2. 查表。這步無條件執行,不看第 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.csv
    

    cn 欄同時收簡體與繁體兩種字形,兩種都要試。有命中就照 tw 欄改。

    為什麼候選詞不能自己挑:直覺只挑得出你已經知道有問題的詞。實測讓模型自行「挑出可疑的詞」,它挑的是本來就認得的那幾個,真正查了才會的詞一個都沒進 pattern,等於沒查。你覺得沒問題的詞,才是最需要查的那些。

    全篇一次餵完,不要逐段查、也不要每改一個詞就重跑一次。腳本一次讀整份草稿、一次列出所有命中列;命中清單看完一次全部改完,改完只需要照第 5 步再跑一次確認,不必每改一處就重新查一次。實測這樣拖到十幾次工具呼叫,慢,而且每一步都是可能斷掉的地方。

  3. 產出後自我檢查一次,以下任一項成立即為不通過:

    • 出現「絕對禁用」或「中國軟體圈行話」表裡的詞
    • 一詞多義的詞用錯義項
    • 出現「AI 味速查」刪除清單或替換表裡的詞
    • 破折號、假對比、三項式排比、加粗超過量化上限(含整句加粗)
    • 開場復述問題,或收尾出現「希望這些資訊對你有幫助」
    • 中文句子用了半形標點,或程式碼與檔名沒加反引號
    • 英文專有名詞被翻譯掉(React、useState、API 要保留)
  4. 通過:直接輸出,不要開啟 guidelines.md。

  5. 未通過:讀 guidelines.md,重寫後再檢查一次。

  6. 只輸出通過的版本,不要提及檢查或查表過程。

Minimal Example

使用 React,在 `useEffect()` 中載入資料。
檔案位於 `src/components/Button.tsx`。

References

Last Updated: 2026-08-09

コメント