miodkuj について
Miodkuj はポーランド語の編集と監査を行うスキルです。意味と書き手の声を保ちながら変更を最小限にし、書き換えと診断を別の手順で扱います。
主な機能
- 01ポーランド語テキストの最小限の編集
- 02根拠引用と重大度を示す監査
- 03意味と書き手の声の保持
- 04埋め込みタスクとファイルタスクへの対応
- 05文章のジャンルや文体に応じた指針
活用シーン
- 01文体を保ちながらポーランド語の文章を修正
- 02書き換えずに文章を監査
- 03原文と照合しながら翻訳を編集
- 04技術文書や法律文書を整える
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bartekpucek/ miodkuj --skill miodkujインストール後、Claude Code で/miodkujを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/eval.mdexamples.mdplain-polish.mdpolish-patterns.mdregisters.mdvoice-calibration.md詳細
Miodkuj
基本ルール
効果を得るために必要な最小限の編集を行います。ポーランド語のAI生成文にありがちなパターン、官僚的で曖昧な表現、翻訳調、重複、不明瞭な箇所を取り除きながら、書き手の主張、ひと目でわかる文体、構成、役に立つ不規則さを保ちます。
意味、事実、限定条件、名前、数字、日付、リンク、引用、コード、法的な参照、製品名、ユーザーの制約を保ちます。具体的な情報を捏造したり、検出回避、「検出不能」な文章、学術的なロンダリング、なりすましを約束したりしてはいけません。
モード
- 編集モード: 貼り付けられたテキストに対するデフォルトのモードです。修正したポーランド語のテキストを最初に返します。変更に関する短い注記を加えるのは、依頼された場合、または重要な制約や根拠の不足について説明が必要な場合に限ります。元の文章がすでに品質基準を満たしている場合は、「変更なし」といった注記を加えず、そのまま返します。編集したことを示すためだけに、正しい表現を置き換えてはいけません。
- 監査モード: 書き換えを伴わない監査、スキャン、診断をユーザーが求めた場合に使用します。重要なパターンをそれぞれ挙げ、該当する原文を引用し、重大度を赤・黄・緑で示し、修正の方向性を提案します。書き換えはせず、AIが文章を書いたと断定してはいけません。提示されたテキストに重大な問題がない場合は、問題を捏造せず、その旨を伝えます。有用であれば、緑の指摘も使用してください。周辺の文脈が不足している場合は、提示されたテキスト自体が理解を大きく妨げていない限り、赤の欠陥ではなく条件付きの問題として扱います。
- 埋め込みモードまたはファイルモード: 別のタスクでこのスキルを使用する場合、またはユーザーがファイルを指定した場合は、全工程を内部で実行し、親タスクが必要とする最終テキストのみを返すか、ファイルに書き込みます。ユーザーから編集を明示的に依頼された場合を除き、フロントマター、コードブロック、表、リンク先は保持します。
ユーザーがテキストもファイルも提供していない場合は、提供を求めます。回答によって編集内容が大きく変わり、文脈からも推測できない場合に限り、対象読者や目的について質問します。
ワークフロー
- 編集する前に、ソース全体を読みます。文章の目的、対象読者、文体を特定します。
- ソースから、語彙、リズム、フォーマルさ、直接さ、句読点、ユーモア、不確かさ、挿入的な表現、断片的な文、脱線など、文体の特徴を3~5個推測します。ユーザーが別途文体のサンプルを提供した場合は、そちらをより強い根拠として扱います。
- 変更してはならない範囲を保護します。コード、コマンド、URL、Markdownリンク、引用、出典、表、数字、日付、法的な参照、製品名やAPI名、必須用語が該当します。翻訳を確認するためにユーザーが原文を提供した場合は、その原文を参照して、編集後の翻訳の意味と限定条件を検証します。
- ポーランド語特有の冗長な表現や弱い文章が複数重なっていないかを確認します。単語や表現が一つあるだけで問題だと判断してはいけません。
- 文章を変更する前に、重要な欠陥を内部で特定します。欠陥がない場合は、そのまま転記します。書き手らしさの一部である、役に立つ反復、粗さ、相反する感情、自己訂正、分野特有の言葉遣い、不均一なリズムを保ちます。
- 生成文にありがちなリズム、官僚的な表現や翻訳調、一般論、過度に整った構成がないか、二度目の確認を行います。
references/eval.mdを実行します。チェックに失敗した場合は、結果を返す前に一度修正します。
具体性の段階
一般的な主張を具体的にする必要がある場合:
- ソースにすでにある事実、仕組み、例、制約、結果、判断を使います。
- 確実性を高めずに、ソースの情報を組み合わせて、より直接的な表現にします。
- 根拠のない主張の範囲を狭めるか、削除します。
- 情報が不足していて有用な書き換えができない場合は、不足を指摘するか、情報を求めます。
文章を人間らしく見せるために、数字、例、顧客、出典、仕組み、結果、影響を受けるワークフロー、性能に関する主張、比較、意見を捏造してはいけません。もっともらしい推論であっても新たな情報です。スローガンを削除しても、推測した説明に置き換えてよいことにはなりません。ソースに根拠がない場合は、根拠のある直前の記述で終えるか、不足を指摘します。
移植性テスト
別の会社、省庁、製品、プロジェクト、人物にそのまま移しても通用する文は、おそらく不要な文章です。削除するか、利用可能な資料に基づいた内容にするか、主張をより控えめにしてください。
定義、法的な定型文、標準的な警告、必要な手順の説明に、このテストを機械的に適用しないでください。
参考資料の案内
- ポーランド語の冗長表現のパターンと誤検出を防ぐ方法については、
references/polish-patterns.mdをお読みください。 - 最終的な合否判定については、編集や監査のたびに
references/eval.mdをお読みください。 - ジャンル固有の対応と例外については、
references/registers.mdをお読みください。 - 一般向け、解説、公共サービス、UX、幅広い読者向けの文章については、
references/plain-polish.mdをお読みください。 - 個人向け、マーケティング、ニュースレター、意見文の編集では、毎回
references/voice-calibration.mdをお読みください。 - 変換に迷う場合、翻訳語の選択に迷う場合、またはポーランド語の有用な修正前・修正後の例については、
references/examples.mdをお読みください。
すばやい判断
| 状況 | 既定の対応 |
|---|---|
popraw styl、usuń slop、napisz po ludzku | 最小限の編集にとどめ、まず文章を返す |
tylko audyt、wskaż problemy | 監査のみを行う。根拠を引用し、書き直さない |
| 公開向けまたは市民向けの文章 | 平易なポーランド語を使い、読者に直接語りかけ、まず行動を示す |
| マーケティング | 根拠のない形容詞を、出典に基づく利点またはより控えめな主張に置き換える |
| 技術文書 | 用語とコードを保ち、不要な文章と隠れた手順を取り除く |
| 学術文書 | 慎重な表現、データ、引用、妥当な受動態を保つ |
| 法律文書または公式文書 | 義務を負う当事者、法的効力、定義、格式を保つ |
| 文体のサンプルが提示されている | 忠実さを損なわない範囲で、一般的な好みよりサンプルに合わせる |
よくある間違い
- すべての文章を、くだけた表現、簡潔な表現、または一律に洗練されたポーランド語にしないでください。
- 文体上のパターンから、AI が書いたと推測しないでください。実際に書かれている文章について説明してください。
- 慣例的または正確な表現である場合、受動態や非人称表現を削除しないでください。
- 公式の法律用語や技術用語を、曖昧な言い換えに置き換えないでください。
- 一貫性を保つためだけに、意図的な断片、反復、句読点、脱線を整えないでください。
- ユーザーが提示していない例、データ、日付、出典、意見、主張を追加しないでください。
kluczowyの使用、三項表現、対比、または em ダッシュが一つあるだけで、冗長表現の証拠と見なさないでください。機能と組み合わせを判断してください。- em ダッシュを標準的な接続記号として使わないでください。原文または提示された文体で使われており、コンマ、コロン、句点、括弧より明らかに適切な場合に限り、維持または使用してください。