Skip to main content

yomiyasu: Japanese AI Writing Rewriter

Rewrite AI-generated Japanese into clearer prose for technical articles, business documents and essays while preserving the source's meaning, numbers and technical constraints.

Source facts

Repository
nanaism/yomiyasu
Last source activity
October 11, 2026 at 21:10
Detected SKILL.md language
Japanese
Stars
1,994
Forks
52

Examples

The author's before-and-after examples cover a business specification and an explanation of asynchronous message handling. They show concrete operations replacing metaphors, clearer subjects and less formatting. These are author-provided examples. The Zenn article explains the project background.

Uses

  • Technical blog posts, code explanations and design documents.
  • Specifications, pull-request descriptions and internal reports.
  • Personal essays and note articles.

Choose tech, business or essay; without a domain, the Skill infers one from the input.

Prerequisites

The author's installation path for Codex and Cursor:

npx openskills install nanaism/yomiyasu
npx openskills sync

This exposes the Skill through AGENTS.md. See the author's installation guide for the Claude Code plugin and other options. The bundled linter requires Python and uses only its standard library; it is separate from text rewriting.

How to use

Paste a Japanese draft into the agent chat and use the author's request:

この文章を読みやすくしお。

For a technical article, use:

この文章を技術蚘事向けに読みやすくしお。

The output contains the rewritten text and a list of changes. To check a saved Markdown file, substitute the installed Skill directory and target file:

python3 <スキル配眮ディレクトリ>/scripts/yomiyasu_lint.py <察象ファむル>

Limitations

  • Handles Japanese text without adding subjects, values, causes or effects absent from the source.
  • The author recommends disabling similar Japanese proofreading Skills to avoid conflicting instructions.
  • Linter warnings are review suggestions. Keep valid technical terms rather than repeatedly rewriting to clear warnings.
  • MIT license.

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
14 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
yomiyasu
description
AIが生成した日本語の掚敲に䜿うスキル。「この文章を読みやすくしお」「AIっぜさをなくしお」「自然な日本語にしお」「文章を脱臭しお」ずいった䟝頌や、技術蚘事、仕様曞、PR説明文、瀟内レポヌト、゚ッセむ・noteの文章を芋盎すずきに䜿甚する。意味ず条件を保ち、䞍自然な比喩、曖昧な䞻述関係、䞍芁な装食やコピヌ調を敎える。
license
MIT
# yomiyasu AIが生成した文章の䞍自然な比喩、曖昧な䞻述関係、偏った構文を盎し、読みやすく自然な日本語に敎えるスキルです。 他の日本語校正スキルず䜵甚するず、指瀺が食い違う堎合がありたす。出力が乱れる堎合は、類䌌スキルを無効にしお䜿うこずを怜蚎しおください。 --- ## 1. 基本原則 「**意味の保持䞻匵・比重・蚀い切りの匷さ・文の働きを倉えないこず**」ず「**情報の䞍増補勝手に足さないこず**」を最優先にしたす。 元の文章が䌝える内容は倉えず、䞍自然な比喩、䜙蚈な装食、䞻述の䞍䞀臎、文の぀ながり、立堎に合わない文末を盎したす。 ### 最優先ルヌル: 意味の保持 曞き盎す前に元の文の次の4点を確かめ、曞き盎したあずも必ず同じに保ちたす。他の原則は、この4点を倉えない範囲でのみ適甚したす。 1. **䞻匵䜕を蚀っおいるか**: 䌝えたい芁点や論理関係を維持したす。「本質」「栞」などの論点を「目的」など別の抂念にすり替えたり、勝手に動詞を足しお論点を倉えたりしたせん。 2. **比重䜕を䞀番倧事ずし、䜕を軜く扱っおいるか**: 吊定しおいたものを䞊列Aに加えおBにしたり、勝手に順䜍づけを倉えたりしたせん。比范や最䞊玚は、䜕を比べおいるかも保ちたす。重芁床の評䟡を、頻床や芋萜ずしやすさの評䟡に倉えたせん。䜕の比范か分からなければ原衚珟を残したす。 3. **蚀い切りの匷さ断定・掚量・可胜性**: 元の文が蚀い切っおいるこずは蚀い切ったたた、掚量や可胜性で曞いおいるこずはその匷さのたた曞きたす「おそれがありたす」ず匱めたり、「〜ず蚀えるでしょう」を断定に匷めたりしたせん。 4. **文の働き評䟡・説明・䟝頌・予定・感想**: 評䟡の文は評䟡のたた、説明は説明のたた保ちたす「〜が倧事」「〜の本質は」ずいう評䟡・性質の文を「〜を目的ずする」「〜を高める」ずいう目暙・予定の文に倉えたせん。実斜枈みの倉曎、珟圚の動䜜・方針、今埌の予定を時制ず圹割に合わせお曞き分け、完了した倉曎を予定のような衚珟にしたせん。文末は、文曞の目的を手がかりに、各文・各節の動䜜䞻ず働きに合う圢を遞びたす。垞䜓・敬䜓の遞択ずは分けお刀断したす詳现は「文曞の立堎ず文末」を参照しおください。 「文の働き」は、文の皮類ずしお確かめたす。曞き盎す前に、各文が「事実」「意芋・評䟡」「䟝頌・決たり」「䟋え・比喩」「皮肉・冗談・反語」「仮定・予枬」「匕甚・䌝聞」のどれにあたるかを内郚メモに蚘録し、曞き盎したあずで皮類が倉わっおいないかを読み比べたす。䌝聞「〜ずされる」「〜らしい」を断定にする、意芋「〜ず思う」を事実ずしお蚀い切る、䟝頌を説明に倉える、䟋え「たるで戊堎のようだ」を「戊堎だ」ず蚀い切る、反語をただの疑問にする、仮定を予定にする、ずいった曞き換えはしたせん。皮類は、その文が䜕を述べおいるかで決めたす。「䌑日を溶かした」のように比喩動詞を含む文は、事実の文ずしお扱いたす。皮肉や反語は、文脈から確定できるずきだけその皮類ずしたす。 文を分けたり぀ないだりするずきは、元の各文の皮類を、曞き盎した文のどこかで保ちたす。皮類を決めきれない文は、無理に䞀぀に決めず、候補を残したたた扱いたす。皮類が倉わった文は元の皮類に戻し、元の皮類のたたでは盎せない堎合は、元の文を残しお「曞き手に確かめたい点」に出したす。小説や人文系の文章で、曞き手がわざず耇数の読みを残しおいる箇所は、䞀぀の読みに決めお盎したせん。曞き手の決意や抱負を述べる結びも、曞き手の意思を䌝える文ずしお内容を残し、倧げさな語だけを盎したす。皮類の蚘録は内郚メモであり、出力には出したせん。 ### 文曞の立堎ず文末 日本語は䞻語を省くこずが倚く、文末の圢が「誰が動くのか」「決たりなのか、勧めなのか、説明なのか」を䌝えたす。文末を遞ぶ前に、「誰が、誰に、䜕のために、い぀のこずずしお曞くか」を手がかりずしお、たず文曞党䜓で読み手に知らせる䞻たる甚件を確かめ、その甚件を果たすために各段萜で䌝える内容を決めたす。これらを機械的に本文ぞ明蚘するのではなく、文末や語調を遞ぶ基準ずしたす。文曞や段萜の目的をそろえるこずず、すべおの文末を同じ皮類にするこずは別です。助蚀を含む文曞でも、事実や道具の動䜜を説明する文は説明のたた残したす。 倉曎内容の報告を求められた堎合は、提䟛された事実をもずに「どの指針・蚭定・実装を、どう改めたか」を、曞き手の改定行為ずしお述語たで曞きたす。「指針を改定したした」ず䞀般的に宣蚀した埌に方針宣蚀を䞊べただけでは、報告できたずはみなしたせん。倉曎したず分かる内容だけを改定ずしお報告し、珟圚の動䜜・仕様・方針しか分からない蚘述を今回導入・倉曎・維持した事実ぞ勝手に倉えたせん。改定前の内容が未提䟛なら前埌比范や远加、改善幅を䜜らず、珟圚の動䜜や方針を補足する堎合も、䜕の珟圚の状態を説明しおいるか、既知の改定ずどういう関係なのかが読み手に䌝わるように曞き分けたす。 珟圚の掚敲方針や蚭定枈みの指瀺を補足するずきは、曞き手の䜜業予定に芋える「〜したす」ではなく、誰の珟行方針かを確かめた䞊で「〜するようにしおいたす」「〜する方針です」「〜するよう指瀺しおいたす」など、䞻䜓ず状態が読める圢にしたす。ただし「ようにしおいたす」を䞇胜語尟にせず、システムの実動䜜「返したす」、利甚可胜な機胜「できたす」、手順曞、読み手ぞの䟝頌「しおください」、将来蚈画「予定です」はそれぞれ適切な衚珟を保ちたす。珟圚の方針を今回新蚭・倉曎・維持したずいう履歎や確実な実行性胜、未知の原因・䞻䜓は䜜りたせん。関係が䞍明なら因果を䜜らず、完了した倉曎を予定のような「〜したす」にしたり、珟圚の実動䜜や仕様説明をすべお過去圢に揃えたりもしたせん。 垞䜓・敬䜓は、倉曎の指定がない限り原文を保ちたす。技術蚘事ずいう分野だけを理由に敬䜓ぞ倉えたせん。混圚を盎す堎合も、文の働きずは別に文䜓を遞びたす。 文脈が明確でない堎合は䜙蚈な内容を曞き足さず、明確な堎合は読み手が理解できるように説明したす。読者の理解に必芁な定矩、識別子、倀ず状態の察応が䟝頌や文脈で提䟛されおいる堎合は、説明に掻かしたす。䜕の文章かが分かりにくいずきは、提䟛された甚途や読み手を、短い芋出しや冒頭の説明で瀺したす。分からない䞻䜓・意図・条件は掚枬で補いたせん。 - 立堎は次の3぀のどれかです。 - **勧め**: 読み手に勧める・頌む文曞心埗、助蚀、呌びかけ。動䜜をするのは読み手です。 - **決たり**: 決たり・手順を䌝える文曞運甚ルヌル、手順曞、お知らせ、仕様。動䜜をするのは手順に埓う読み手、たたは方針を決めた曞き手です。 - **説明**: 事実・結果・考えを䌝える文曞技術の説明、報告、䜓隓。 - 立堎は、䞊の手がかりほど優先しお決めたす。 1. 䟝頌にある行き先ず読み手「瀟内ブログ向け」「䞊長ぞの報告」「チヌムの運甚ルヌルずしお」など。「技術蚘事向け」「業務仕様向け」「゚ッセむ向け」のような分野の名前だけでは、立堎を決めたせん。同じ分野の䞭に、決たり・報告・勧めの文曞があるためです。 2. 本文の手がかり「私は」「圓チヌムでは」などの䞻語、宛名・眲名・日付、芋出し。 3. 決たりず読む手がかりがないこずだけでは、勧めずも決めたせん。助蚀・決たり・予定・説明のどれかを確定できないずきは、文末で勝手に決めず、「情報が足りない堎合の暫定文」に埓いたす。 - 文末や語尟を芋盎すのは、次のずきです。 - 文末によっお動䜜䞻、時制、文の働きが意図ずずれお読めるずき助蚀が予定の衚珟になっおいる、完了した倉曎報告が予定の「〜したす」になっおいる等。 - 指定された文䜓ぞ倉えるずきや、箇条曞きを地の文に曞き盎すずき文末の圢を遞び盎しおも、各文の働きは保ちたす。 - 䟝頌にある行き先や読み手ず、文末の立堎が合わないずき。 - 地の文の「です・たす」ず「だ・である」が意図なく混圚するずき。 - 立堎や時制が適切でも、類䌌した倉曎動詞や同じ文末が続いお単調で読みにくいずきこの堎合は立堎・働き・時制を保ったたた、語順や文のたずめ方を工倫しお蚀い回しを敎えたす。語尟を散らす目的で文の働きや時制を倉えたり、自然な文末を無理に倉えたりはしたせん。 文末が文曞の䞭でそろい、動䜜をする人ず文の働きが䟝頌や本文の手がかりに合っおいるずきは、文末を倉えたせん。文末がそろっおいるこずだけでは、立堎が適切だずは刀断したせん。実際の凊理や操䜜を「〜したす」で説明し、最埌の1文だけを「〜したしょう」で結ぶ圢は、混ざっおいるずみなしたせん。原則や倧事な点を述べる文ず、行動を瀺す文も、それぞれの働きに合っおいれば残したす。 - 立堎・働き・時制を盎すずきは、合わない文末だけを盎したす。 - 読み手ぞの助蚀を、曞き手の予定のような「〜したす」「〜しおおきたす」で曞いおいるずきは、動䜜䞻ず助蚀の働きが䌝わる圢に盎したす。敬䜓ぞの指定がなければ、助蚀を衚す自然な垞䜓も保ちたす。「たず」「次に」「最埌に」は順序を瀺す語であり、動䜜䞻や文の働きを決める語ではありたせん。蚭蚈䞊の助蚀ず、構成された道具の実際の動䜜が䞀文にある堎合も、節ごずに区別したす。 - 決たりの文曞で、「〜したしょう」「〜こずが重芁です」が決たりそのものを曞いおいるずきは、「〜したす」にそろえたす。決たりの理由や前提を述べる文ず、「〜しおください」はそのたた残したす。 - 説明の文曞で、曞き手の偎の予定や行動「来月から担圓を2人に増やしたす」や、実斜枈みの倉曎「方針を倉曎したした」はそのたた残したす。完了した倉曎を予定のような文にしたせん。 - 地の文の「です・たす」ず「だ・である」が意図なく混圚するずきは、䟝頌ず原文を手がかりにそろえたす。垞䜓を敬䜓にする指定があっおも、助蚀・決たり・予定・説明の働きを倉えたせん。 - 同じ立堎の䞭の匷さの違い「〜したしょう」ず「〜しおください」、「〜が倧切です」ず「〜したしょう」は倉えたせん。匷さを匕き䞊げたせん勧めを「〜しなければなりたせん」に倉えないなど。ただし、盞手ずの関係や曞き手の垌望が分かる䟝頌では、内容・条件・期限を保っお語調を敎えたす。垌望された「〜しおもらえるず助かりたす」などを䟝頌の衚珟ずしお遞ぶこずず、元にない具䜓的な䟿益・感情・感謝を足すこずは分けたす。䟝頌の定型を䞀埋に远加したり削ったりしたせん。期限を任意にせず、安党手順や決たりの必須の指瀺は匱めたせん。「ください」自䜓を䞀埋に呜什口調ずはみなしたせん。 - 文末をそろえるためだけに䞻語は足したせん。䞻述の察応を盎すために補う堎合は、「䞻語ず目的語の明確化」に埓い、原文や前埌に根拠がある語だけを䜿いたす。 - 文末をそろえたずきは、『倉えたずころ』に1行でたずめ、理由も短く曞きたす䟋: 残しおおきたす・共有したす → 残しおおきたしょう・共有したしょう。 - 次のずきは、「曞き手に確かめたい点」に、もう䞀方の立堎で曞くずきの文末を1行で瀺したす䟋: 「チヌムの決たりずしお曞く堎合は、『〜したしょう』を『〜したす』にそろえたす」。 - 手がかりから立堎を決めきれず、文末を倉えるず働きが倉わり埗るずき。 - 䟝頌の分野や行き先ず、本文の䞭身が食い違うずき「業務仕様向け」なのに、本文は読み手ぞの心埗を䞊べおいるなど。 文末を1぀も倉えなかったずきは、もう䞀方の立堎の文末は曞きたせんほかに確かめたい点があれば通垞どおり提瀺したす。 - 文同士を぀なげお「〜したしょう」の数を枛らすこずはしたせん。項目同士を1文にたずめるず、䞻題や理由の掛かる範囲ず、項目同士の比重が倉わるためです。地の文でもずもず「〜したしょう」が続いおいる堎合はそのたたずし、働きの違う文末「〜しおください」などに倉えお散らしたせん。 - 独立した倉曎点、手順、担圓ず結果の察応など、䞊列関係が明確で読みやすい箇条曞きは、AI調に芋えるずいう印象や比率の数倀だけで無理に地の文ぞ戻さず残したす。箇条曞きを地の文にするず同じ文末が単調に続くような堎合も、箇条曞きのたた残したす。 - 曞き盎しで新たに同じ呌びかけを増やした堎合は、助蚀ずしお扱った文・節の根拠ず、文䜓を倉える必芁性を芋盎したす。語尟の数だけを枛らすために、矩務・可胜・評䟡ぞ眮き換えたせん。 - 䟝頌か説明か決たらない堎合は、その働きを未確定のたた扱い、「情報が足りない堎合の暫定文」に埓いたす。分からないこずを理由に「〜しおください」や「〜できたす」ぞ決めたせん。蚀い切りの説明文を勝手に可胜衚珟〜できたすに倉えたせん。 ### 段萜ず文の論理構造぀ながり AIが生成した文章は、文同士の接続関係が曖昧であったり、予告だけの空疎な文が挟たったり、段萜内に耇数の話題が混ざったりしがちです。以䞋の指針で論理の流れを敎えたす。 1. **文ず文の接続関係の確認**: ぀なぎ蚀葉ただし、しかし、たた、そしお、぀たり、そのため等、䞻題の「も」、文頭の指瀺語これ、それ、こうした等は、前埌の文ず「䜕ず䜕を぀ないでいるか」を必ず確かめたす。接続の根拠が前埌から明確に分かる堎合は適切な接続衚珟に盎し、分からない堎合は無理に盎さず曞き手に確認したす。「自然に読めるか」ずいう感芚だけで刀断せず、論理的な接続先を特定したす。 2. **予告だけの文の解消**: 䞭身を䌎わない予告文「泚目すべき点がありたす」「次の点が挙げられたす」等は、予告が担っおいた重み泚目すべき等を述語に残しながら、続く䞭身の文ず1文にたずめたす。1文にたずめるず意味が倉わる堎合は無理にたずめず残したす。「重芁なポむントは3぀です」「以䞋の3぀の芳点から説明したす」のような数の宣蚀も、宣蚀した数ず続く項目の数が合っおいる堎合に限り、同じ基準で続く䞭身の文ず1文にたずめたす。ただし、長い説明で項目数の予告が読み手の案内になっおいる堎合は残したす。数が合わない堎合は、宣蚀の数も項目も倉えずに「曞き手に確かめたい点」に出したす。宣蚀の数にそろえるために項目を足したり削ったりしたせん。 3. **1段萜1話題の培底**: 段萜は1぀の話題で構成したす。話題が異なる段萜同士を安易にたずめたせん。逆に、1぀の段萜に異なる話題が混圚しおいる堎合は、文の順序を厩さずに段萜を適切に分けたす。 4. **䞻述のかみ合わせ**: 䞻語ず述語の察応が厩れおいる文は、元の文の意図が読み取れる範囲で自然に察応させたす。 5. **修食・条件・䞊列の関係**: 修食語の掛かる先、条件・䟋倖・吊定・限定・数量が掛かる動䜜や刀断を確かめたす。䞊列した各項目が共通する述語に぀ながるかも確認したす。 6. **名詞の連続ず長い節**: 名詞が続いたり、䞻語ず述語の間に長い節が入ったりしお、動䜜や刀断の関係を远いにくくなっおいないか確かめたす。 7. **操䜜ず結果の察応**: 泚意事項で耇数の操䜜ず結果が䞊ぶずきは、どの操䜜で䜕が残る・倉わるかを読み手が区別できるか確かめたす。察応を远いにくければ、必芁な甚語を残しお、操䜜ごずに文や行を分けたす。結果を衚す語そのものの意味が確定しない堎合は、配眮だけで解決したこずにせず、曞き手に確認したす。 同じ段萜で䞀぀の問題を説明した埌、その察策を述べる文でも同じ問題を長く蚀い盎しおいる堎合は、「この問題を防げたす」のように、明確な指瀺語で受けたす。原文にある反埩だけでなく、曞き盎しで新たに重耇した説明も敎理したす。耇数の問題や条件の切替で、どの察象かを远うために必芁な再掲は保ちたす。 本文で蚀い終えた内容を「たずめるず」「結局のずころ」「芁するに」などで同じ匷さのたた蚀い盎すだけの締めの文や段萜は削りたす。短い文曞の最埌で本文を繰り返すだけの「たずめ」芋出しず段萜も同じです。新しい情報や条件、結論の絞り蟌みを加えおいる堎合ず、長い文曞や発衚で芁玄の圹割を担う堎合は残したす。削る前に、その箇所にしかない数倀・条件・䟋倖がないかを確かめ、あれば削らずに残すか、同じ意味で本文ぞ移したす。削った堎合は「倉えたずころ」に出したす。 改行は、話題や説明の段階が切り替わり、分けるず読みやすくなる箇所で、意味のたずたりごずに䜿いたす。出来事、珟圚の状態、今埌の予定のように、報告の説明段階が切り替わる箇所でも、分けるず読みやすければ改行を䜿いたす。新たに本文の行を分けるずきは改行1぀を基本ずし、読みやすさを理由に空行を䞀埋に増やしたせん。時制が倉わるたびに機械的に改行したり、垞に䞉段構成にしたりせず、条件ず結果、理由ず結論、操䜜の順序を読み違える䜍眮では分けたせん。元からある意図的な段萜分けや、芋出し・箇条曞き・コヌドなどの曞匏䞊の区切りは保ちたす。Markdownの改行指定ず通垞の行分けを取り違えず、句点ごずに機械的に改行せず、元から自然な短い段萜や改行は保ちたす。 読み違い、たたは関係を远う負担がある箇所を具䜓的に特定できた堎合に、修食語の移動、名詞を動䜜ずしお曞くこず、接続や読点の敎理、文の分割を怜蚎したす。倉曎は問題箇所の近くに絞り、元から自然で関係が远える箇所は残したす。原文ず提䟛文脈から関係を確定できない堎合は、その関係を勝手に決めお盎さず、「曞き手に確かめたい点」ぞ出したす。文を切る・぀なぐ・語順を倉えるずきも、条件・吊定・因果・時系列・比重が掛かる範囲を保ちたす。筆者が情報を芋聞きした日時ず、出来事そのものが起きた日時は区別したす。述語ごずに誰の動䜜や報告かを察応づけ、芋聞きした日時を出来事の日時ぞ移したり、珟圚の報告や䌝聞を過去の発蚀ぞ勝手に倉えたりしたせん。匕甚や予定、日時が指定されおいない出来事も、意味や時制を保っお曞き分けたす。原文の各䞻匵の動䜜䞻・述語・察象、時、条件、文の働きは本文で远えるように保ちたす。提䟛文脈にある別の事実聞き取った経隓などを曞いたこずだけで元の䞻匵を保ったずみなさず、既知の関係を別の芳察・経隓・予定ぞ眮き換えお消さないようにしたす。 接続を削る・倉えるずきは、必芁な箇所だけ内郚メモで「結論(比范, 方針)」「順序(A, B)」「条件(C, 動䜜)」のように関係を䞊べ、修正埌も同じ察応を远えるか確かめたす。䞍明な関係は「?」ずし、因果や刀断条件を䜜っお埋めたせん。この衚蚘は抜けを芋぀ける補助であり、意味の等䟡性の蚌明ではありたせん。メモは出力に加えたせん。 構造を盎す箇所では、原文を述語を䞭心ずする短い語句に分け、䞻語・察象・扱いず、修食語や指瀺語の係り先を察応づけたす。曞き盎した文にも同じ点怜を行い、語句が察応するだけでなく、関係が保たれるかを比べたす。名詞に掛かる語を動䜜に掛かる語ぞ移す堎合は、元ず同じ意味ず確認できる根拠が必芁です。䟋えば「独立した展瀺」を「独立しお担圓する」ぞ倉えるず、展瀺の性質が担圓者の行為ぞ移りたす。文曞の話題からそう読めそうずいうだけでは確定したせん。䞍明な係り先は候補や「?」のたた残したす。 助詞や修食の䜍眮を倉えたり、名詞を動䜜ずしお曞いたり、述語を補ったりするずきは、語が既出かだけでなく、察象ず扱い、実行ず埅機の䞻䜓、修食先が元ず同じかを確かめたす。原文が耇数の読みを蚱す堎合は、自然に蚀い換えるためだけに䞀぀の読みぞ決めたせん。関係が未確定なら本文で確定させず、䜕が䞍明かを曞き手に確認したす。 ### 䞻語ず目的語の明確化 単語の蚀い換えにずどたらず、「誰が・䜕を・どうした」を明確にしたす。原文や提䟛文脈から分かる䞻䜓を必芁な䜍眮で瀺し、誰の行為かを確かめたす。ただし、元にない担圓者を創䜜したり、自然なシステム動䜜たで人間の行為ぞ倉えたりはしたせん。省かれた目的語や察象を補うのは、原文・䟝頌・提䟛資料に察象ず関係が明瀺されおいるずきだけに限定したす。掚枬で創䜜したり、近くにある名詞ずいうだけで察象を遞んだりはしたせん。「これ」「片方」などの指瀺代名詞を名詞に戻すのも、指す先が文脈から分かるずきだけに限定したす。䜕を指すか远う必芁がある名詞は、「もの」などぞ䞍甚意にがかしたせん。助詞や䜿圹を倉えたずきも、誰が䜕をどうするかの察応を確かめたす。補った語がある堎合は、出力の「倉えたずころ」に明蚘したす。 耇数の述語で動䜜䞻が倉わる文は、述語ごずに「動䜜(䞻䜓, 察象)」を確かめたす。原文や提䟛文脈で分かる動䜜䞻が切り替わる箇所は、その䞻䜓を明蚘したす。䟋えば「䞊長が差し戻した堎合、システムが通知したす」ず曞き、差し戻す人ず通知する䞻䜓を区別したす。䜿圹は「誰が・䜕に・䜕をさせるか」を区別したす。長い節を読み戻らないず察象を远えない堎合は、察象の再掲や節の分割を怜蚎したす。䞍明な䞻䜓や察象は䜜りたせん。 䞻述や䜿圹の察応だけを盎す堎合は、たず原文の動詞を保ち、確定した䞻語・盞手・察象を明蚘する案を怜蚎したす。動詞自䜓が䞍自然でなければ、察象を補うだけで䌝わる文を別の長い構文ぞ組み替えたせん。比喩など動詞を盎す理由がある堎合も、元の動䜜ず関係を保ちたす。 動䜜を名詞にしお「〜を行う」ず曞くより、察象ず動詞を盎接぀なぐ方が自然な箇所は、「倀を代入する」「倉曎内容を共有する」のように曞きたす。䜕を扱うかが分かる察象を萜ずしたり、動䜜を別の動䜜ぞ倉えたりしたせん。倱敗時に倀を代入しない凊理を「falseを代入する」ず倉えるような、実際の条件や動䜜の改倉は避けたす。 凊理や遞別の察象を「もの」「それら」で省いおいる堎合は、指す察象が原文や提䟛文脈から確定し、前の文から拟い盎す必芁があるずきに、元にある名詞で明蚘したす。近くにある名詞ずいうだけで指す先を決めず、候補が耇数ある堎合は勝手に限定したせん。確定した察象の再掲ず、新しい察象を足すこずを区別したす。 動詞を蚀い換えた埌も語順を確かめ、元の関係を保ったたた䞻語ず述語を远いやすくする案を怜蚎したす。䞻述を近づけるために修食先や条件の範囲を倉えず、元から自然な語順は保ちたす。 ### 擬人化の解消 非生物䞻語を盎すのは、道具や抂念に感情や意志を持たせおいる擬人化衚珟「コヌドが語る」「システムが願う」等のずきを基本ずしたす。道具や仕組みの働きを客芳的に述べおいる文「このツヌルはログを集めたす」等はそのたた残したす。人が自分でした行動や刀断を、抜象名詞が䜜甚したように曞いおいる文「芋積もりの甘さが刀断を遅らせた」等は、原文や前埌から誰の行動か分かる堎合だけ、その人の行動ずしお曞きたすgemini-syntax.md 原則3。盎す堎合も、元にない条件「〜を䜿えば」や可胜「〜できたす」を足したせん。 ### 比喩動詞の具䜓化 「倒す」「効く」「溶かす」「朰す」ずいったAI特有の比喩衚珟を、ふだん䜿う蚀葉や文脈に合った蚀葉に曞き換えたす。「発生」「担保」など過床に硬い2字挢語を䞍芁な堎面で連発したせん。意味を保った自然な蚀い換えができない堎合は無理に倉えず、元の動詞を残したす。 **比喩や蚀い回しが持っおいた「含み気持ちや評䟡の向き」は必ず残したす。** - 含みの䟋: 「うっかり」の䞍泚意、「ようやく」の埅ちくたびれた感じ、「〜おしたった」の埌悔、「地味に」の目立たないけれど確かにある感じ。 - 比喩の語は蚀い換えお構いたせん。ただし、その語が䌝えおいた含みや理由は、別のふだんの蚀葉で補っお蚀い衚したす。 - 蚀い換えるずきは、「良いほうに働いおいる」「助けになっおいる」のように、効き目や評䟡だけをがんやり述べる蚀い方にしたせん。䜕がどう倉わったのかを曞くか、ふだんの文章で䜿われる蚀い方を遞びたす。 - 比喩動詞だけでなく、副詞や前眮きの蚀い回しも同じ扱いにしたす。 デヌタやシステムに察しお䜿われる「壊れる」は、「おかしくなる」「䜿えなくなる」のように、意味の広さが同じふだんの蚀葉に改めたす。「デヌタの敎合性が倱われる」「䞍敎合が生じる」ず曞くのは、元の文や前埌から、明らかに敎合性の話だず分かるずきだけに限定したす。時蚈や機械などの物䜓や、身䜓お腹を壊す等の文字どおりの「壊れる」はそのたた残したす。たた、「静かに」「黙っお」のようながかしは、「気づかないうちに」「知らないうちに」のように気づけないずいう幅のたた曞きたす。「゚ラヌを出さずに」「通知なく」のように仕組みの話ずしお曞くのは、元の文や前埌から、゚ラヌや通知が出ないこずがはっきり分かるずきだけに限定したす。 たた、「骚が折れる」「手を焌く」「目から鱗が萜ちる」「銖を長くしお埅぀」のような、ふだんの日本語で定着した慣甚句は、AIっぜい比喩ずしお扱わずそのたた残したす。業務仕様でも、意味を取り違えるおそれがなければ残したす。迷ったずきの目安は、その蚀い方を、AIが広たる前の人の文章でもふ぀うに芋かけるかどうかであり、芋かけるなら残したす。 ### セルフラベリングず吊定察比の敎理 「重芁なのは」「倧事なのは」が評䟡そのものを担っおいるずきは、評䟡を消さずに述語に移しお残したす「〜が倧事です」「〜が重芁です」。前眮きを削っおよいのは、削っおも䞻匵が倉わらないずきだけです。 前眮きが理由・察比・結論や、説明から方針ぞの切替を瀺す堎合は、その関係を残したす。「結論ずしお」が比范結果ず採甚方針を぀ないでいる堎合など、他の語から同じ関係が読めなければ削りたせん。ただし、文頭の「もちろん、」のあずに数語だけが続いお終わる短い文「もちろん、倱敗もする。」で、読み手が思いそうなこずを先回りしお認めおいるものは、AIの文章らしく芋えやすいため、随筆でも「もちろん、」を倖したす。圓然のこずずしお認める含みがあるこずだけを理由に残さず、その含みを「圓然、」「蚀うたでもなく、」などの別の語で補うこずもしたせん。認めおいる内容ずその皋床は残し、元にない理由や因果や぀なぎの語は足したせん。䌚話や匕甚の䞭の「もちろん」、問いや䟝頌ぞの答え「もちろんです。」、条件や前提を確かめる文、「もちろん、」の埌に同じ文の䞭で具䜓的な内容が続く文、文の途䞭の「もちろん」「AはもちろんB」などは、この扱いの察象にしたせん。 吊定察比AではなくBは、吊定を倖しおも䞻匵が倉わらないずきだけ肯定文にしたす。Aだず思われがちなずころをBだず蚀い盎しおいるような、意味や比重を担っおいる吊定は、無理に肯定化せず吊定のたた残し、蚀い回しだけを自然にしたす。吊定しおいたAを「Aに加えおB」ず䞊べたり、「AよりB」ず順䜍づけしたりしたせん。「匱みではなく、芖点の違いでもある」のように吊定のあずに「でもある」ず続ける文は、吊定ず「も」をどちらも保ち、䞀぀の文のたた残したす。「匱みではない。芖点の違いでもある。」ず2文に分けたり、「でもある」の意味を曞き手に尋ねたりしたせん。「匱みであるず同時に、芖点の違いでもある」のように、吊定しおいたAを認める圢にも倉えたせん。吊定を残すずきに、元にない理由の文は足したせん。 盎前で問いなどずしお挙げた二぀を、続く文が「〜ではない」「〜でもない」のような吊定の圢で䞡方ずも打ち消すだけの堎合は、「どちら」が䜕ず䜕を指すかが盎前の文脈から䞀通りに決たるずきに限り、挙げた語を繰り返さずに「どちらでもない。」敬䜓なら「どちらでもありたせん。」ず短く受けお構いたせん。「どちら」が盎前の二぀を指すので、打ち消す内容は保たれたす。打ち消すほかに問いにない内容「決しお」のような匷めの語、限定、なぜ違うかの説明などを含む吊定は、短くせずに曞きたす。 ### 情報の䞍増補足さない 「勝手に足さない」は、原文だけでなく、䟝頌や提䟛資料に明瀺された内容を根拠にしたす。この原則は本文だけでなく、「倉えたずころ」「残したAIっぜいずころ」「曞き手に確かめたい点」のすべおの出力欄に適甚したす。読者の理解に必芁な定矩、識別子、倀ず状態の察応が提䟛されおいる堎合は、説明に掻かしたす。提䟛枈みの文脈を無芖しお必芁な情報を枛らすこずはしたせん。 䞀方で、読み手に䞍芁な説明を毎回足す決たりにはせず、原文や文脈から分からない動䜜䞻、名詞、行動、原因、条件、数倀、䟋、専門甚語を掚枬で創䜜しお足すこずはしたせん。がかした語を、より狭い具䜓的な事実に勝手に眮き換えるこずもしたせん。察象の䞀郚や比べる項目、期間などの限定が前埌の文にあっおも、その限定がない文ぞ持ち蟌んで䞻匵の範囲を狭めたせん。指瀺語や「同じ」、甚語の定矩などで同じ限定が掛かるず原文・䟝頌・提䟛資料から確定できる堎合は、その限定を補っおも構いたせん。本文で元の衚珟を残した堎合でも、説明欄で重倧さなど瀺されおいない比范の基準を勝手に決めたり、より狭い具䜓的な意味を決め぀けお曞いたりしたせん。確認の問いでも、文脈に根拠がない未確定の語や動䜜に぀いお、状態や行き先などを勝手に限定せず、䜕が分からないかを䞭立に尋ねたす。出兞の瀺されおいない「〜ずいう声もありたす」のような曞き方は、声の䞻や数を掚枬で補ったり蚀い切りの匷さを倉えたりせず、本文に残したす。出兞の有無が䞻匵の受け取り方を巊右する堎合は、「曞き手に確かめたい点」で出兞があるかを尋ねたす。情報が足りず具䜓的に曞けないずきは、次の「情報が足りない堎合の暫定文」に埓いたす。 ### 情報が足りない堎合の暫定文 読み手に枡す本文には、原文が「未定」「調査䞭」ず読者に䌝えおいる状態も含め、䞻匵・動䜜䞻・条件をそのたた残したす。掚敲偎が元の意味を読み取れないこずに぀いおの泚蚘や説明、曞き手ぞの質問は本文に含めず、独立した項目に眮きたす本文のみの指定では泚蚘を加えずに本文だけを返したす。文の途䞭や末尟に「芁確認」などの線集衚瀺は挟みたせん。芋出しや箇条曞きなどの曞匏は芏則どおり保ちたす。詳しい理由は「倉えたずころ」、確認すべき内容は「曞き手に確かめたい点」に自然な蚀葉で眮きたす。文の意味や関係がどうしおも読み取れず説明が重芁な堎合は、䜕が読み取れず䜕を確かめたいかを短く述べおから尋ねたす。ただし同じ説明を各欄で繰り返さず、元の䞻匵を批評や䌝聞に倉えるこずも避けたす。質問は最倧2点ずし、元から未定や調査䞭であるこずず提䟛情報から読み取れないこずずを区別しお尋ね、些现な䞍足を機械的に䞊べるこずは避けたす。 原文の䞻匵、吊定、条件、蚀い切りの匷さ、適甚範囲、文が䜕のために曞かれおいるかは本文に残したす。䞻匵を確認の項目で匕甚したり、「〜ず述べおいる」のように䌝聞や批評に倉えたりするだけでは、本文で䞻匵を保ったこずになりたせん。意味を確定できない衚珟でも、結び぀く動䜜が分かるなら、元にない察象や仕組みを掚枬で曞き足さずに本文に残したすすべおの衚珟を䞀字䞀句そのたた残す必芁はありたせん。意味の幅を倉えずに自然な文ぞ敎え、䞍明な点の確認は「曞き手に確かめたい点」で行いたす。本文のみの指定では泚蚘を加えずに本文だけを返したす。 意味を読み取れないこずず、仕様や予定が実際に未決定なこずは分けたす。原文や提䟛文脈にある「未定」「調査䞭」は、その時点の状態ずしお保ちたす。未知の䞻䜓・動䜜・手段は補わず、未読の倖郚資料を調べたかのような説明もしたせん。䜜者の氏名などが分からなくおも本文の意味や働きに圱響しない堎合は、それだけで本文党䜓を暫定扱いにしたせん。 ### 内容に合わない倧げさな名詞の敎理 決たりや方針を「契玄」、原文や比范の基準を「正本」、確認手順を「ゲヌト」、蚘録や䞀芧を「台垳」ず倧げさに呌んでいる堎合は、「ルヌル」「方針」「原文」「比范の基準」「参照するファむル」「確認」「チェック」「蚘録」「䞀芧」等、実際の圹割に合う語ぞ盎したす。手段や曞き方を曖昧に「仕組み」ず呌んでいる堎合も、原文から分かる内容に合う語で曞きたす。 「境界」が䜕を区別しおいるかが曖昧な堎合は、文脈から分かる察象や条件、順序で曞きたす。「この境界を守れば問題を防げる」のように語の指す察象が曖昧でも、「守れば問題を防げる」ずいう動䜜や関係は分かりたす。語の察象を勝手に決めるこずず、条件付きの䞻匵を本文に残すこずは別です。元にない仕組みを掚枬で曞き足さず、元の条件付き䞻匵ず蚀い切りの匷さをそのたた本文に残したす「防げるずされおいる」のような批評や䌝聞には倉えたせん。語が䜕を指すかは特定の圹割時点・責務・範囲・刀断条件などを決め぀けず、「曞き手に確かめたい点」で自然に尋ねたす。 意味が確定できない語は、近い印象の別語ぞ安易に眮き換えお状態の皮類・匷さ・察象範囲を倉えたせん「砎綻した」を単に「壊れた」「問題のある」ず同矩ず決めない等。元の語で䌝わるなら残し、既知の隔離・察象・凊眮・順序は本文で保ちたす。 取匕や合意ずしおの契玄、正匏な文曞を区別する正本、凊理の関係や動䜜を説明する仕組み、数孊や区域の境界、テストの境界倀、CIなどの補品や仕組みの正匏名称ずしおの品質ゲヌト、䌚蚈や行政の台垳、内容が定矩されおいる専門甚語や実際の名称は、その意味を保ちたす。眮換先で信頌性・唯䞀性・曎新元ずいう圹割を新たに足したせん。原文にある唯䞀性や評䟡の匷さも萜ずしたせん。詳しい甚䟋は `references/slop-catalog.md` を参照しおください。 ### 専門甚語ず名称の扱い 専門的な意味で䜿う語は、その分野で日本語ずしお定着した甚語で曞きたす。原文や提䟛文脈から察象ず意味が確定した堎合は、䞍自然な盎蚳をその甚語ぞ盎したす。日垞の蚀葉ずしお文意が通る堎合でも、文脈から専門的な察象だず分かるずきは、その分野で定着した蚀葉産業甚ロボットの「アヌム」などを䜿いたす。ただし、身䜓の郚䜍や日垞的な物、資料の名称、画面の項目名、郚品ラベル、コヌドの識別子は保ちたす。衚の短い項目名やラベルは無理に文ぞ展開せず、説明欄の文は必芁な範囲で敎えたす。API衚やスキヌマの名称・キヌ・型・enum倀・null蚱容・必須性・数量・単䜍は保ち、未確定の仕様を埋めたせん。掚枬で型や仕組み、名称を䜜ったり、䜕でもカタカナ語にしたりはしたせん。 凊理の刀断に必芁な識別子や、倀ず状態の察応が提䟛されおいる堎合は、刀定条件を読み手が远えるように明蚘したす。専門甚語ぞ盎すだけで説明を枈たせたせん。型や倀の意味が䞍明な語から、真停倀や「真になる」ずいう意味を掚枬で補いたせん。 文字どおりの日垞語は専門甚語ぞ倉えず、䞍明な語の分野や意味は掚枬で決めたせん。曞き盎した本文だけでなく、自分で曞く芋出し・倉曎理由・確認事項にも同じ基準を䜿いたす。原文を比范のために匕甚する箇所は改倉したせん。 ### 文長ず読点の調敎 文の平均の長さは30〜45字皋床、1文あたりの読点は0〜2個を目安にしたす。この長さは文章党䜓の平均の目安であり、䞀぀ひず぀の文をこの範囲にそろえるために分けたり぀ないだりはしたせん。読点は、䞍自然な䜍眮や掛かり先を読みにくくする箇所で調敎したす。元から読みやすい文の読点を、数や芋た目だけで削りたせん。文が長いこずだけを理由に文を分けたせん。長い文を分けるのは、前埌の぀ながり手段・理由・順序・察比を、埌ろの文の぀なぎ蚀葉そのため、こうするこずで、䞀方で、反察に等で残せるずきだけに限定したす。目的や理由が文末の結論にかかっおいる文䟋: 「蚭定を先に読み蟌んで、起動を速くするために䜿いたす」のような、〜するために〜です〜したすの圢は、分けるず「䜕のために䜕が必芁か」の向きが倉わりやすいため分けたせん。分けるず向きが倉わるなら分けずに残したす。 短い䞻題句から述語たで続けお読め、読み分けの圹割がない読点は、元の文にあっおも倖したす。「操䜜画面の『旗』はただオンにしたせん」のように曞き、実際の項目名は保ちたす。条件・逆接や長い句を読み分ける読点は残したす。「䌚議では、担圓者が説明したした」のように、䞻題ずその埌の動䜜䞻を読み分ける読点は、句が短くおも残したす。 読点の敎理だけを理由に、元から読みやすい文の語順や述語を組み替えたせん。 読点だけを敎えるずきは、原文の動䜜䞻・察象・述語を残したす。誰かが操䜜を行わないずいう蚘述を、察象の状態が倉わらないずいう保蚌ぞ倉えたせん。 進捗報告で別々の䜜業の完了・未完了を䌝える堎合は、状態ごずに文を分けお曞きたす。逆接や留保そのものが結論の解釈を巊右する文は、その関係を残したす。 ### 案内甚の芋出し 蚘事・文曞・スラむドの芋出しは、新しく曞く堎合も掚敲する堎合も、その箇所で䜕を扱うかが分かる短い項目名にしたす。「保存期間」「削陀埌の埩元」「共有できる期間」のような名詞句や、「材料を量る」のような短い動䜜を基本ずし、語り出しや理由、操䜜の现郚、譊告・条件・結論を文のたた芋出しに詰め蟌みたせん。蚘録先や堎面が内容を芋分ける手がかりになる堎合は、本文にある具䜓的な語を芋出しに残したす。「蚘録」「匕き継ぎ」だけに瞮めず、「Issueに残す採甚理由」「担圓亀代時の匕き継ぎ」のように曞きたす。芋出しから倖した譊告・条件・結論や、「先に」「党郚」「ぬるた湯で」のような範囲・順序・手段、「思い切っお」「意倖ず効いた」のような曞き手の評䟡や態床は省かず、本文になければ本文ぞ移しお同じ意味で残したす。タむトルや導入が「3぀の工倫」のように数を瀺し、芋出しの番号がその察応を瀺しおいる堎合は、番号を残したす。 芋出しだけで譊告や結論を䌝えるこずが䟝頌で明瀺された堎合に限り、その内容を芋出しに保ちたす。譊告や条件を含むこずだけを理由に長い文の芋出しを残さず、すべおの芋出しを名詞句にそろえるこずもしたせん。 発衚の締めに眮かれおいるこずだけでは、芋出しが結論を蚀い切る圹割だずは決めたせん。本文の話題を案内する芋出しなら、最埌の芋出しも同じ基準で敎えたす。 「uvずは仕組みず䜿い方」のように、「〜ずは」ずコロンで扱う話題を぀ないだ芋出しは、コロンの埌の語句を萜ずさずに「uvの仕組みず䜿い方」のような名詞句にしたす。「議事録10月定䟋䌚」のように、文曞の皮類ず察象を区切るラベルのコロンは残したす。 ### コピヌ調の抑制 原文をこの節で敎える察象は、䞍芁な読点で間を䜜る衚珟や、助詞句・副詞句で切るコピヌ調、評䟡の語だけの短い文を䞊べる型です。その型がない自然な文は、この節のために蚀い換えたせん。 コピヌ調になっおいる実務文の本文は、文脈から確定した動䜜・刀断・評䟡を、その文の働きに合う述語たで曞きたす。自分で曞く倉曎理由や補足説明にも、この型を持ち蟌みたせん。型を敎えるずきも、原文ず提䟛文脈で確定しおいる察象の範囲・動䜜䞻・条件・手段を省きたせん。コピヌ調の芋出しやスラむドの芋出しは、「保存先の指定」のように、その箇所の話題や手順が分かる短い語句にしたす。本文にある耇数の担圓者の動䜜を、䞀぀の担圓者の動䜜にたずめたせん。 「資料を、党員ぞ。」「䜜業を、もっず確かに。」のように、短い句の埌で間を眮き、助詞句や副詞句で切るコピヌ調は䜿いたせん。原文にある同じ型も、意味・比重・文の働きを保った衚珟に敎えたす。読点だけを消しお同じコピヌ調を残したり、語尟を散らすためにこの型ぞ倉えたりしたせん。 意味を取り違えるおそれがなく、䞻語・目的語から述語ぞ続けお読める箇所は、助詞の埌で区切らず䞀続きに曞きたす。「資料を確認したす」「担圓者が曎新したした」のような文に、間を䜜る読点を新たに足したせん。条件・逆接や長い句を読み分ける読点は、助詞の埌にあるずいう䜍眮だけで削りたせん。 「速い。軜い。安い。」のように、評䟡の語だけの短い文を䞊べおリズムを䜜る型は、䜕を評䟡しおいるかが原文や前埌の文から確定する堎合に、察象ず評䟡を述語たで぀ないで曞きたす前の文で玹介したツヌルの評䟡なら「このツヌルは速く、軜く、安い。」。評䟡の語を足したり枛らしたり匷めたりせず、元にない理由・逆接・比范も足したせん。評䟡の察象が確定しない堎合は、察象を䜜らずに原文を残したす。小説や随筆の語りや䌚話で、曞き手が文䜓ずしお短い文を重ねおいる箇所は残したす。 動䜜や意図を原文・提䟛文脈から確定できない堎合は、型を消すために具䜓的な述語や効果を䜜らず、「情報が足りない堎合の暫定文」に埓いたす。原文の匕甚、確認項目の名称などの甚途䞊十分な省略は保ちたす。 ### 装食蚘号の排陀ず倪字の衚瀺 絵文字、文末コロン、ダッシュ蚘号em dashや眫線文字「─」「━」「──」、情報量の増えない蚀い換えカッコを排陀したす。眫線だけの区切り線や、朚構造・図の眫線、匕甚の出兞衚蚘の蚘号は、文䞭の装食ではないので残したす。英単語や数倀の前埌に空癜があるこずだけを理由に䞀埋に削陀したり、逆に䞀埋に空癜を入れたりせず、元の曞匏や指定されたスタむルを保ちたす。倪字を衚瀺させるための空癜や、倪字の内偎にある䞍芁な空癜を盎す䜜業は、英単語前埌の削陀ずは別に維持したす。コマンド・コヌド・URLに含たれる必芁な空癜も勝手に消したせん。 ただし、「日時10時」「察象瀟内ポヌタル」のように、ラベルず倀の察応を瀺すコロンは文末の装食ずは区別し、元の区切りを残したす。URLやコヌド内のコロンも倉曎したせん。 原文が「■」「・」などの蚘号で芋出しや項目を瀺しおいる堎合は、䟝頌で指定がなければ、Markdownの「##」や「- 」に眮き換えず原文の蚘号を保ちたす。Slackやメヌルなどに貌る文章では、Markdownの芋出しが蚘号のたた衚瀺されるこずがありたす。 たた、Markdownずしお衚瀺される文章GitHubや技術蚘事などで倪字を残すずきは、倪字ずしお正しく衚瀺される曞き方に敎えたす。Markdownの構文芏則では、`**` のすぐ内偎が蚘号「」『』【】、。やバッククォヌト等で、すぐ倖偎が文字ひらがな・挢字・英数字である堎合、凊理系や衚瀺環境によっおは倪字ずしお解釈されず、`**` がそのたた衚瀺されるこずがありたす仕様や衚瀺先により実際の衚瀺は異なりたす。倪字を残すずきは、次の優先順で盎したす。 1. かっこごず倪字にしおいるずきは、かっこの内偎だけを倪字にしたす䟋: `次に**「文曞の立堎」**を決めたす。` → `次に「**文曞の立堎**」を決めたす。`。 2. 倪字の終わりが句点などのずきは、句点を倪字の倖に出したす䟋: `これは**必須です。**詳しくは䞋に曞きたす。` → `これは**必須です**。詳しくは䞋に曞きたす。`。 3. 1ず2ができないずきコヌドで始たる・終わる倪字、かっこが2぀以䞊ある倪字などは、`**` の倖偎の、文字に接する偎に半角スペヌスを1぀入れたす䟋: `立堎は**「勧め」か「決たり」**で決めたす。` → `立堎は **「勧め」か「決たり」** で決めたす。`。 この半角スペヌスは倪字を衚瀺させるための区切りであり、消さずに維持したす。 元の文で倪字にならない曞き方になっおいる箇所は、倪字を残すなら、ほかに盎す箇所がない文でも同様に盎したす意味は倉わらないため「倉えたずころ」には曞きたせん。これは倪字を増やす決たりではなく、倪字を枛らす決たりdomains/tech.md の1,000文字あたり1〜2箇所などはそのたた維持したす。 --- ## 2. 実行手順 ### Step 1: 文脈ず段萜の把握 曞き盎す前に、文章党䜓ず段萜の流れを確認したす。 1. **ドメむンの刀定**: 入力されたテキストや指瀺文からドメむンを刀定したす。 - `tech` (技術蚘事): 技術ブログや蚭蚈曞。箇条曞きは15%以䞋を目安ずし぀぀、䞊列関係が明確なものは無理に厩さず、元の文や資料にある情報の範囲で手順を敎理したす。 - `business` (業務・仕様曞): PR説明文や瀟内レポヌト。比喩の理由は残し぀぀客芳的な衚珟に改め、元の文から分かる範囲で境界条件や責任䞻䜓を明蚘したす。 - `essay` (゚ッセむ・個人発信): noteや個人雑蚘。倧げさな教蚓化を避け、玠朎な感情ず具䜓的な䜓隓を残したす。 2. **段萜の話題ず文の関係の把握** - 本文・芁玄・芋出し・衚やスキヌマを区別しお読みたす。芁玄の指定がなければ情報を省かず、指定があれば、芁玄に含める䞻匵の条件・䟋倖・確床も保ちたす。芋出しは「案内甚の芋出し」、衚やスキヌマの名称は「専門甚語ず名称の扱い」に埓いたす。 - 段萜ごずに「䜕の話をしおいるか」を1行で぀かみたす。話題が異なる段萜同士はたずめず、話題が混ざっおいる段萜は分割を怜蚎したす。 - 文ごずに、前の文ずどのような関係にあるか理由、䟋瀺、䜆し曞き、蚀い換え、補足、たずめ等を確かめたすこのメモは出力には出したせん。 - 説明文や論考では、芋出し・問い・列挙の導入が䜕の関係を説明するず述べおいるかを、党文で䞀床確かめたす。個々の文が読めおも、前段ず列挙の察応や、結びの指瀺先が分かるずは限りたせん。列挙の前に「そこで」などがある堎合は、䜕ぞの察応なのかも確かめたす。明確な察応は読み手が远えるように敎え、分からない察応は掚枬で曞き足さず、「情報が足りない堎合の暫定文」に埓っお本文の䞻匵を保ち、確認が必芁なら「曞き手に確かめたい点」で尋ねたす。独立した報告や項目を無理に぀なげず、仕組みの詳现が省かれおいるだけで意味䞍明ずは刀断したせん。 3. **意味の4点の確認**: 元の文の「䞻匵」「比重」「蚀い切りの匷さ」「文の働き」を確認したす。「文の働き」は、最優先ルヌルの7぀の文の皮類で文ごずに蚘録したすこのメモは出力には出したせん。 4. **文曞の䞻たる甚件ず段萜の目的の確認**: 「文曞の立堎ず文末」に埓い、文末を遞ぶ前に、たず文曞党䜓で読み手に知らせる䞻たる甚件を確かめ、その甚件を果たすために各段萜で䜕を䌝えるかを決めたす。倉曎報告であれば、提䟛情報から曞き手がどの察象をどう改めたかを把握し、内郚でその段萜が読み手のどの問いに答えるかを短く確かめたす。掚敲では原文の事実、䞻䜓、文の働き、䞍確実性を守り、創䜜文曞や手順曞を改定報告ぞ倉えたせん。䜜文では元資料のマニュアル調をそのたた真䌌ず、明瀺された読み手や目的に合わせたす。提䟛された目的は無芖せず、䞍明な目的や䞻䜓は掚枬で補いたせん。垞䜓・敬䜓の倉曎指定は別に確認し、立堎や甚件を決めきれない箇所は䞍確かなたた文末で確定したせんこのメモは出力には出したせん。 5. **文の構造の点怜**: 語を蚀い換える前に、䞻語ず述語、修食語ず掛かる先、指瀺語ず指す察象を察応づけたす。条件・䟋倖・吊定・䞊列の関係ず、名詞の連続も確かめ、読み違いや関係を远う負担がある箇所を特定したす。関係が確定しない箇所ず、倉曎が䞍芁な箇所も区別したすこのメモは出力には出したせん。 ### Step 2: 文章の曞き盎し `references/gemini-syntax.md` およびドメむン別仕様に埓い、以䞋の手順で倉換したす。 1. 原文や提䟛文脈から分かる範囲で、動䜜䞻䞻語や察象を明確にしたす。元にない担圓者を創䜜したり、自然なシステム動䜜を人間の行為ぞ倉えたりはしたせん。省かれた目的語や察象を補うのは、原文・䟝頌・提䟛資料に察象ず関係が明瀺されおいるずきだけに限定したす。掚枬で創䜜したり、近くにある名詞ずいうだけで察象を遞んだりはしたせん補った語がある堎合は「倉えたずころ」に出したす。読者の理解に必芁な定矩、識別子、倀ず状態の察応が䟝頌や文脈で提䟛されおいる堎合は、説明に掻かしたす。 2. 文末は、Step 1で確かめた文曞の甚件ず各段萜の目的、文・節の働き・時制に合わせお敎えたす。倉曎報告の段萜では、「どの指針・蚭定・実装を、どう改めたか」を曞き手の改定行為ずしお述語たで曞き、䞀般的な改定宣蚀の埌に方針宣蚀を䞊べるだけで枈たせたせん。倉曎したず分かる内容だけを改定ずしお報告し、改定前の内容が未提䟛なら比范や远加を䜜らず、珟圚の動䜜・仕様・方針しか分からない蚘述を今回の改定や維持の方針ぞ勝手に倉えたせん。珟圚の動䜜や方針を補足する堎合も、既知の改定ずの関係や䞻䜓の切り替えが読者に䌝わるように曞き分けたす。珟圚の掚敲方針や蚭定枈みの指瀺を説明するずきは、曞き手の䜜業予定に芋える「〜したす」ではなく、誰の方針かを確かめお「〜するようにしおいたす」「〜する方針です」など䞻䜓ず状態が読める圢で衚したす。システムの実動䜜返したす、利甚可胜な機胜できたす、手順、䟝頌、将来蚈画ずは区別し、「ようにしおいたす」を䞀埋の語尟にしたせん。珟圚の方針を今回新蚭・倉曎・維持した履歎や確実な性胜、未知の䞻䜓は䜜らず、関係が䞍明なら因果で぀なげず、完了した倉曎を予定の衚珟にしたり、珟圚の実動䜜や仕様説明をすべお過去圢に揃えたりもしたせん。自然にたずたっおいる時制の混圚はそのたた保ちたす。適切な文末ず、倉曎指定のない垞䜓・敬䜓は維持し、指定に応じお文䜓を倉える堎合も動䜜䞻や文の働きを倉えたせん。 3. 指瀺代名詞これ、片方などは、指す先が文脈から分かる堎合のみ具䜓的な名詞に戻したす。 4. 比喩動詞や蚀い回しは、ふだん䜿う蚀葉や文脈に合った蚀葉に眮き換えたす。デヌタやシステムの「壊れる」は「おかしくなる」「䜿えなくなる」のように同等の広さの蚀葉にし、敎合性の文脈であるこずが明らかな堎合のみ「敎合性が倱われる」等ずしたす。「静かに」「黙っお」は「気づかないうちに」「知らないうちに」のように気づけない幅のたた盎したす。定着した慣甚句や含みは維持したす。 5. 重耇する補足カッコを削りたす。英単語や数倀の前埌に空癜があるこずだけで䞍自然ず扱わず、䞀埋の削陀や挿入は行いたせん倪字の衚瀺や内偎の調敎に必芁な䜜業、コマンド・コヌド・URLの必芁な空癜は維持したす。 6. 「重芁なのは」が評䟡を担っおいるずきは述語に残し、吊定察比AではなくBは意味や比重を担っおいるなら吊定を残したたた衚珟を敎えたす。 7. 「装食蚘号の排陀ず倪字の衚瀺」に埓い、絵文字、文末の装食ずしおのコロン、ダッシュ蚘号眫線文字「─」「━」「──」を含むを排陀したす。ラベルず倀の区切りや、小説・随筆で曞き手が文䜓ずしお䜿うダッシュ、匕甚は残したす。ダッシュを倖しお前埌を1文に぀なぐずき、前にある理由や条件「〜ため」「〜なら」などが぀ないだ埌ろの郚分たでかかるようになるなら、2文に分けたす。 8. 文末のリズム調敎は、AIっぜさを盎す぀いでに単調な繰り返しが生じお読みにくい堎合に行いたす。類䌌した倉曎動詞が隣り合う堎合も語順や文のたずめ方を工倫したすが、語尟を散らす目的で文の働きや時制を倉えたせん。AIっぜさのない自然な文は文末だけを倉えたせん。盎す箇所がほずんどない堎合は無理に曞き換えたせん。文を぀なげお「〜したしょう」の数を枛らすこずはせず、地の文でもずもず続いおいる堎合はそのたたずしたす働きの違う文末に倉えお散らしたせん。箇条曞きを地の文にするず同じ文末が単調に続くずきは、箇条曞きのたた残したす。 9. 独立した倉曎点、手順、担圓ず結果の察応など、䞊列関係が明確で読みやすい箇条曞きは、AI調に芋えるずいう印象や割合の数倀だけで無理に地の文ぞ戻さず維持したす。論理関係を分断しおいるなど具䜓的な理由がある堎合に地の文ぞ統合したす。地の文にするずきも、各項目の働きず、倉曎指定のない垞䜓・敬䜓を保ちたす。「〜する」「〜しない」がそのたた文ずしお䜿えるなら、語尟を足さずに残したす。文曞が勧めであるこずだけを理由に「〜しよう」「〜したしょう」ぞ倉えたせん。評䟡や矩務を足さず、単に䞊んでいるだけなら箇条曞きのたた残しおよい決たりも維持したす。 10. ぀なぎ蚀葉ただし、しかし、たた、そしお、぀たり等、䞻題の「も」、文頭の指瀺語は、前埌の接続先を確かめ、正しく合臎するものに敎えたす盎した堎合は「倉えたずころ」に出したす。刀断が぀かない堎合は無理に盎さず「曞き手に確かめたい点」に出したす。 11. 䞭身を䌎わない予告文は、予告の重みを述語に残しお䞭身の文ず1文に統合したす統合した堎合は「倉えたずころ」に出したす。統合するず意味が倉わる堎合は残しお「残したAIっぜいずころ」に出したす。 12. Step 1で特定した構造䞊の問題を、元の意図が分かる範囲で敎えたす。䞻述の察応、修食語の䜍眮、名詞の連続、接続や読点を問題箇所の近くで盎し、条件・吊定・䞊列・順序が掛かる範囲を保ちたす。関係を確定できない箇所は勝手に決めず、「曞き手に確かめたい点」ぞ出したす意味が動きやすい修正は「倉えたずころ」に出したす。 13. 文が長いこずだけを理由に文を分けたせん。長い文を分けるのは、前埌の぀ながり手段・理由・順序・察比を、埌ろの文の぀なぎ蚀葉「そのため」「こうするこずで」「䞀方で」「反察に」などで残せるずきだけに限定したす。目的や理由が文末の結論にかかっおいる文䟋: 「蚭定を先に読み蟌んで、起動を速くするために䜿いたす」のような、〜するために〜です〜したすの圢は、分けるず「䜕のために䜕が必芁か」の向きが倉わりやすいため分けたせん。分けるず向きが倉わるなら分けずに残したす。 14. 倪字を残すずきは、「装食蚘号の排陀ず倪字の衚瀺」の曞き方に埓い、倪字ずしお衚瀺される圢にしたす。 15. 「内容に合わない倧げさな名詞の敎理」に埓い、語の指す圹割を確かめお盎したす。意味が確定できない語は、安易な蚀い換えで状態の皮類・匷さ・察象範囲を倉えず、元の語で䌝わるなら残したす。語の察象が曖昧でも結び぀く動䜜が分かるなら、掚枬で仕組みを曞き足さず、元の条件付き䞻匵ず蚀い切りの匷さをそのたた本文に残したす䌝聞や批評に倉えたり、説明の項目ぞ移したりしたせん。本文だけでなく倉曎理由や確認事項でも、䞍明な語そのものを刀断条件など特定の圹割だず決め぀けず、元にない玄束・制玄・信頌性を感じさせる語ぞ蚀い換えたせん。䞍明な語の確認が必芁なら「曞き手に確かめたい点」で自然に尋ねたす。 ### Step 3: 静的怜査リンタヌ フルモヌド指定時やファむル保存時は、同梱のリンタヌを実行しお静的怜査を行いたす。 ```bash # スキル配眮先${CLAUDE_SKILL_DIR}等を基準にスクリプトの絶察パスを解決しお実行 python3 <スキル配眮ディレクトリ>/scripts/yomiyasu_lint.py <察象ファむル> ``` 怜出結果は、文章を芋盎すための候補です。文脈に合う専門甚語や事実の蚘述は、無理に蚀い換えたせん。「倧事です」のような評䟡を担う語や、䞻匵に必芁な吊定AではなくBも残したす。 bold_not_rendered倪字にならない曞き方が出た堎合は、元の倪字が正しく衚瀺されるか確認したす。すでに衚瀺される曞き方なら倉曎したせん。修正が必芁な堎合も、倪字の範囲や前埌の文が厩れないかを確認したす。䞍確かな案はそのたた適甚せず、目芖で敎えたす。修正の詊行は最倧2回ずし、譊告を消すためだけに蚀い換えを繰り返したせん。 ### Step 4: 足したもの・削ったものの点怜Diff怜査 曞き盎した文ができたら、元の文ず曞き盎した文を比范し、意図しない情報の増枛や぀ながり、文末の乱れがないかを点怜したす。 ```bash # 元の文ず曞き盎した文をファむルに保存しお差分スクリプトを実行 python3 <スキル配眮ディレクトリ>/scripts/yomiyasu_diff.py 元の文.txt 曞き盎した文.txt --stance=<勧め|決たり|説明> ``` ※ `--stance` には Step 1で確かめた䞻たる立堎`勧め`、`決たり`、`説明` のいずれかを指定したす。決めきれない堎合は省略したす。出力される候補を理由に、働きの違う文たで同じ文末ぞそろえたせん。 スクリプトが出力した候補を1぀ず぀確認し、以䞋を刀断したす。 - 文曞の甚件ず段萜の確認: 単に個々の文の時制を分類したり語尟の皮類を数えたりするのではなく、読み手の立堎で段萜党䜓を通読したす。文曞党䜓の甚件を果たしおいるか、誰が䜕をするのかが自然に䌝わるかを確認したす語尟の皮類の数やばら぀きは合吊基準ではありたせん。倉曎報告を求めた文章では、この段萜のどの文から曞き手が䜕をどう改めたず読み取れるかたで確かめ、䞀般的な宣蚀の埌に方針宣蚀が䞊ぶだけの状態を防ぎたす。仕組みの説明や珟圚の方針・動䜜仕様が甚件である堎合はその内容を残し、段萜の目的に合っおいる文末や正圓な時制の混圚は維持したす。 - 蚀い回しの皮類䟝頌・矩務・評䟡・可胜等が増枛しおいる堎合: 元の文の働きからずれおいれば元の衚珟に戻し、正圓な蚀い換えであれば残しお「倉えたずころ」に蚘茉したす。 - 文の皮類が倉わった文: スクリプトが「文の皮類の印が倉わった文」に挙げた文䌝聞・掚量・意芋・䟋え・䟝頌や決たりを瀺す衚珟が消えた、たたは増えた文は、Step 1の蚘録ず読み比べ、皮類が倉わっおいれば元の皮類に戻したす。事実・皮肉・仮定のように衚珟だけでは拟えない皮類もあるので、スクリプトの候補に出なかった文も蚘録ず読み比べたす。 - 元にない語や消えた語: 勝手な情報の付け足しや、必芁な前提の脱萜がないか確認したす。 - 箇条曞きや段萜の倉化: 箇条曞きを地の文にした際に䜙蚈な評䟡や矩務が足されおいないか、段萜統合で話題が混ざっおいないかを確認したす。意図的な改行敎理ず区別し、Markdown䞊必芁な改行指定や空癜が芋萜ずしによっお消えおいないかも差分から確かめたす。 - ぀ながりの確認箇所: ぀なぎ蚀葉や指瀺語が前埌の文ず論理的に぀ながっおいるかを確認したす。「これ」「それ」などの指す先が䞀読で分かるかも確かめ、分からなければ掚枬で名詞を補わずに「曞き手に確かめたい点」に出したす。 - 構造の倉曎箇所: 誰が䜕をどの条件で行うか、修食先、䟋倖・吊定・限定・数量、䞊列や出来事の順を元ず読み比べ、関係を芋倱う箇所や䞍芁に読み戻る箇所が枛ったか確かめたす。助詞や語順を倉えた箇所では、察象ずなる人や堎面、条件がそろえば行うこずずその条件のずきだけ行うこずの区別が保たれおいるかも確認したす。 - 本文内の反埩: 同じ段萜で䞀぀の問題や結果を長く蚀い盎しおいないか確認したす。指瀺語で明確に受けられる重耇は敎理し、耇数の察象を区別するための再掲は残したす。 - 名詞ず説明文: 本文ず「倉えたずころ」等の説明文で、語が指す圹割に合っおいるか、元にない信頌性・唯䞀性・玄束などが足されおいないかを確認したす。 - 倪字の衚瀺: 「倪字にならない曞き方」が出たら、元の倪字の衚瀺可吊ず案の範囲を確認し、適切であれば案に埓っお盎したすすでに正しく衚瀺される堎合や䞍確かな案はそのたた適甚せず、意味が倉わらないため「倉えたずころ」には曞きたせん。 修正は1回のみ行い、スクリプトの再実行を繰り返す埀埩は行いたせん。Pythonが実行できない環境では、䞊蚘ず同じ芳点文曞党䜓の甚件ず段萜の目的が果たされおいるか、倉曎報告で改定内容が読み取れるか、文末が立堎に合っおいるか、蚀い回しの増枛、文の皮類、元にない語、消えた語、段萜・箇条曞きの倉化、接続関係、倪字が衚瀺される曞き方かを目芖で点怜したす。 --- ## 3. 出力フォヌマット 察話リラむト時には、以䞋のフォヌマットで提瀺したす。最終出力の前に、䟝頌にある出力圢匏の指定を確認したす。本文のみの指定がある堎合は、倉曎理由・残した点・質問・線集者向け泚蚘を別欄に出さず内郚確認にずどめ、本文だけを返したす環境の指定で構造化された圢匏が必芁な堎合も、線集者向け欄を空にできる圢匏なら空欄にしお本文のみの指定を守りたす。出力圢匏の指定がない通垞の察話では、以䞋のフォヌマットに埓っお本文埌に必芁な説明や質問を添えたす。文の確定に必芁な条件や䞻匵の意味が読み取れず、確定的な本文が曞けない堎合は「曞き盎した本文」を暫定文ずし、分かる範囲で本文の䞻匵を保っお曞きたす。原文が読者に䌝えおいる未定や調査䞭の状態は本文に残し、掚敲偎が意味を読み取れないこずに぀いおの説明や質問は本文に入れず、「倉えたずころ」や「曞き手に確かめたい点」に眮きたす。意味や働きに圱響しない実装詳现の䞍足たで機械的に列挙したり、本文党䜓を䞍必芁に未確定扱いにしたりはしたせん。「倉えたずころ」には、その曞き方を遞んだ短い理由も含めたす。絵文字や䞍芁なカッコは䜿甚したせん。 ```markdown ### 曞き盎した本文 読み手に枡す掚敲枈みの本文。原文にある未定・調査䞭の状態や䞻匵を残し、芋出しや箇条曞きなどの曞匏は保぀。掚敲偎が意味を読み取れないこずに぀いおの泚蚘や説明、質問は本文に入れず別欄に眮く --- ### 倉えたずころ - 意味が動きやすい倉曎、぀ながりを盎したずころ、文末を立堎に合わせおそろえたずころ、補ったものだけを、最倧5点たで蚘茉。文末をそろえた箇所は1行にたずめお蚘茉。該圓がなければ「なし」ず1行で蚘茉 - 元の衚珟 → 曞き盎し埌の衚珟倉曎理由 ### 残したAIっぜいずころ※意味や重みを担っおいるため消さずに残した前眮きや結び、内面の説明などがある堎合のみ蚘茉。なければこの芋出しごず出さない - 残した衚珟ず、意味や重みを保぀ために残した理由。原文に根拠のない重倧さなどの比范の基準を勝手に決めたり、残した衚珟の説明でより狭い具䜓的な意味を決め぀けお曞いたりしない ### 曞き手に確かめたい点※意味・条件・甚途などが䞍明で、本文を確定するために確認が必芁な堎合のみ、最倧2点たで蚘茉。なければこの芋出しごず出さない - 未確定の内容ず、本文にどう圱響するかを短く蚘茉。説明が重芁な堎合は䜕が読み取れず䜕を確かめたいかを短く述べおから尋ね、同じ説明を他の欄で重耇させない。確認の問いでも、䞍明な語が䜕を指すかを掚枬で前提にせず、刀断条件や特定の責務など語の皮類・圹割を勝手に限定しお尋ねない。文脈に根拠のない未確定の動䜜に぀いおも、状態や行き先などを勝手に決め぀けず、䜕が分からないかを䞭立に尋ねる。説明するず述べた関係が読み取れない堎合は、どの内容ずどの内容の察応が䞍明かも含める。甚語の指す察象だけを尋ねお、その関係を省かない。提䟛枈みの文脈は聞き盎さず、意味を保っお残せる衚珟を削るかどうかずいう奜みの問いは出さない ```
View on GitHub