style-guide-vi

ベトナム語スタイルガイド

ユーザーまたは組織のルールが常に優先されます。スキルのデフォルトは、指示がない場合にのみ使用し、一貫して適用します。引用や固有名詞に、後から恣意的に適用してはいけません。

ワークフロー

1. スタイルガイド、用語集、標準文書、または承認済みの例を探します。ルールの出典を明記します。
2. 呼称、用語、製品名、大文字・小文字、数字、日時、通貨、単位、句読点、書式について、判断表を作成します。
3. 例外の範囲を特定します。コード、URL、識別子、ブランド名、引用、他のシステムから入力されたデータが該当します。
4. 無作為に修正するのではなく、項目ごとに確認します。標準形を選ぶ前に、表記ゆれとその頻度を記録します。
5. 専用のスタイルがない場合は、references のデフォルトを使用し、それがプロジェクトのデフォルトであることを明記します。
6. 修正によって新たな矛盾が生じないよう、相互に確認します。たとえば、呼称を変更したのに丁寧な動詞を見落とすことがないようにします。
7. 要求に応じて、公開用に整えた文書、または変更報告を出力します。

用語を一括で標準化する前に terminology を、Markdownについては formatting を読んでください。

保持

事実、数値、単位、固有名詞、製品名、商標、コード、URL、識別子、引用を保持します。表記を標準化しても、値を変更してはいけません。小数点の規則が決まっている場合に限り、1,5 と 1.5 を変更できます。タイムゾーンは保持する必要があります。

2つのルールが競合する場合、優先順位は、ユーザーからの直接の指示、プロジェクトのスタイルガイド、承認済みの用語集、ドメインの慣例、スキルのデフォルトの順です。

ルールの分類

• 代名詞：読者との関係と一貫性。
• 大文字・小文字：固有名詞、見出し、機能名。
• 数字、日付、単位：数字、パーセント、通貨、時刻、タイムゾーン。
• 用語：用語集、英語、略語。
• 書式：見出し、箇条書き、強調、コード。

避けること

• 専用のスタイルガイドがある場合に、デフォルトを適用しないでください。
• 引用、コード、URL、パス、識別子を修正しないでください。
• 書式の標準化中に数値やタイムゾーンを変更しないでください。
• 地域による違いを誤りとみなさないでください。
• 一般的な大文字・小文字の規則に合わせてブランド名を変更しないでください。
• 一貫性の確認を、著者の文体の書き換えにしないでください。
• AI が生成した文章だと推測したり、検出器向けに最適化したりしないでください。

介入レベルの選び方

兆候があれば、すべての文を必ず修正するという前提は置きません。次のいずれかのレベルを選びます。

• そのままにする：スタイルガイドや用語集に沿っている場合、または「あなた」と「ユーザー」が異なる役割を表すだけの場合。
• 書き換える：選択済みの値、用語、呼称を変えずに形式を標準化する場合。
• 提案する：執筆者による確認が必要な表記ゆれがある場合。
• 著者の判断が必要：呼称が競合している場合、または用語集に優先形がない場合。

出力

短い文書の場合は、標準化済みの文書を返し、重要な判断をいくつか記載します。複数ファイルにわたるコーパスの場合は、適用したルールの表、例外の一覧、オーナーの判断が必要な箇所を返します。examples を参照してください。