better-portuguese について
ブラジル・ポルトガル語の執筆と編集を支援するスキルです。成果物に合わせた文体調整や、意味・モダリティ・技術用語を保つ編集手順を示します。
主な機能
- 01ブラジル・ポルトガル語の編集基準
- 02執筆と改稿のワークフロー
- 03意味とモダリティの保持
- 04文脈に応じた技術用語の扱い
活用シーン
- 01ブラジル・ポルトガル語の文章作成
- 02既存の文体を保ったポルトガル語の修正
- 03意味を変えずに技術文書を編集
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ rafaelquintanilha/ skills --skill better-portugueseインストール後、Claude Code で/better-portugueseを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/editorial-standard.mdgrammar-and-style.mdpunctuation.md詳細
ポルトガル語をより良く
指定された成果物を、自然なブラジルポルトガル語で作成します。タスク自体で別の言語が必要な場合を除き、エージェントの推論、開発指示、ツールとのやり取りには英語を使用します。
この基準はブラジルポルトガル語(PT-BR)向けに調整されています。ヨーロッパ、アフリカ、その他のポルトガル語の用法を、ひそかにブラジルの用法へ正規化しないでください。また、このスキルをそうした用法に対する権威として示さないでください。
このスキルは、独自の見解を持つ編集基準として扱ってください。会話上のペルソナ、一般的な文法チェッカー、あるいは特定のプラットフォームのスラングを模倣する手段として扱ってはいけません。成果物を問わず、ポルトガル語の基準は一貫させてください。長さ、構成、文体、情報密度は、成果物の用途に合わせてください。
新しい草稿を作成するとき、または文体の書き換えを明示的に依頼されたときは、ここで定める独自の文体を適用してください。すでに適切なポルトガル語の文章を校正、レビュー、または軽く編集するときは、その正当な既存の文体を保ち、実際の不備、またはユーザーが再検討を求めた点だけを変更してください。
文レベルの文章を書く場合は、まず 句読点ガイド、次に 文法・スタイルの参考資料を読みます。最後に、成果物を作成または改訂する前に 編集基準を読み、最終的な分解検討が最後に適用する編集指示となるようにしてください。独立したラベル、ボタン、その他の短いインターフェース要素には、句読点ガイドや文法・スタイルの参考資料は必要ありません。
編集ワークフローに従う
- 成果物の要件を明確にします。目的、対象読者、形式、長さまたはスペースの制限、文体、指定されたトーンや感情、必須の事実、保持すべき意味、変更不可のトークン、不確実な点を確認します。不明な制約は慎重に推測してください。提示された URL は装飾的な文脈ではなく、情報源の場所として扱います。ツールを使える場合は、製品名、文法上の慣例、社内用語、主張などが URL の内容に左右されるなら、草稿を作成する前に確認してください。確認できない場合は、不明な慣例や事実を作り出さないでください。
- 成果物で表現すべき命題と関係性を抽出します。原文が英語の場合は、文の構造や修辞的な枠組みをそのまま保つのではなく、命題と関係性を維持してください。スペースが限られている場合は、下位の命題を意図的に省略します。異なる述語を、その役割が変わるような並列構造にまとめないでください。
- ポルトガル語で直接草稿を書きます。ポルトガル語で思考が自然に展開する順序に沿って文章を構成してください。
- 最初の完成稿をいったん脇に置き、編集基準に記載された必須の編集レビューを、実際の文面に対して行います。草稿は別の書き手が書いた文章として扱ってください。まず成果物の要件を確認し、その後、文ごとに構文と語彙を分解して検討します。
- 抽出した命題に立ち返り、影響を受ける構文をすべて書き直します。翻訳文を、単独の類義語の差し替えや、修辞上の要素を一対一で置き換えることで修正しないでください。原文がラベルを積み重ねている場合や、定型的な対比を使っている場合は、命題を節の間で再配置してください。最初の草稿の節の骨組みに問題がある場合は、その場で修正するのではなく、骨組み自体を捨ててください。
- 書き直した成果物をもう一度確認します。文章が自然であり、トーン、フォーマル度、長さ、構成も含めて、成果物が依頼された役割を果たしている場合にのみ完成です。ユーザーが別案、比較、または理由の説明を求めていない限り、編集上のコメントを付けずに返してください。
意味と責任を保つ
- 事実、主張、意図、確実性、不確実性、感情、帰属、約束、範囲を保ちます。
- 行為主体と法性を正確に保ちます。誰かができることを、実際に行っていることや、行うべきことに変えたり、観察された振る舞いを推奨事項に変えたりしないでください。
- 各事実の役割を定める述語を保ちます。文を短くするためだけに、異なる数量や行為を一つの動詞に係らせないでください。
- 保持した法性は、最も簡潔で自然な構文で表現します。法性を変えないためだけに、名詞による言い換えや迂言を使わないでください。
- 原文にある曖昧さを、強めたり、弱めたり、解消したりしないでください。
- 明示的に変更を求められない限り、コマンド、パス、環境変数、識別子、文字どおりのエラーメッセージはそのままにします。製品名や API 名の語形はそのまま保ちますが、以下の説明に従ってポルトガル語の構文に組み込みます。ただし、正確な表示名が明示的に求められている場合は除きます。
文脈に応じて技術用語を決める
- その分野で定着した用語である場合、または翻訳すると精度が失われたり、別の概念を示唆したり、想定読者にとって分かりにくくなったりする場合は、外国語の技術用語をそのまま使います。
- 同等に正確で自然な場合は、慣用的なポルトガル語の用語を優先します。
- そのまま使う用語はすべて、ポルトガル語の構文に組み込みます。用語が示すポルトガル語の概念に応じて、冠詞、性、数、前置詞、周囲の語句を選びます。原語の文法に機械的に合わせないでください。
- 名詞や頭字語をそのまま使う前に、それが表すポルトガル語の主要名詞または概念を特定し、その性と数を冠詞、縮約形、形容詞、後続の言及でも一貫させます。たとえば、インターフェースは
a CLI、技能として理解されるスキルはuma skillとなります。 - 固有名詞には、原文、組織、または関連する言語コミュニティで定着している冠詞と性を使います。会社、サービス、製品、出版物、プラットフォームといった一時的な説明から、固定した慣習を作り出さないでください。繋辞動詞の後に来る述語名詞によって、主語の性がさかのぼって決まることはありません。
- 原文や参照 URL がある場合は、冠詞や
do、da、no、naのような縮約形など、慣習が分かる自己言及の表現を確認します。その証拠を無視して、後から示される分類ラベルから性を導き出さないでください。原文を参照できない場合や、慣習を特定できない場合は、a plataformaやo serviçoのような明示的な主要名詞を使うか、冠詞を必要としない定形の関係表現を使います。推測せず、冠詞や前置詞を単に省いて不自然な名詞の並置にしないでください。 - 技術用語やブランドをそのまま保つ場合も、英語の語順まで保つ必要はありません。原文で正確な表示名が明示的に求められている場合を除き、固有名詞と一般的な技術名詞は、語順にかかわらず構文上のまとまりとして扱います。語句自体はそのままにし、ポルトガル語に適した位置に分類語を置き、適切な前置詞で由来、所有、関連を示します。例:
o SDK do Atlas、a API do serviço。o Atlas SDKのように英語の名詞の連結を再現したり、a API Atlasのように関係を省略したりしないでください。 - そのまま使う用語の説明は、対象読者や初出時の文脈で必要な場合に限ります。固定の用語集に頼らず、意味、分野、対象読者に基づいて判断してください。