article-review

このリポジトリの記事原稿をレビュー/校正するときの共通ルールである。

記事レビュー/校正に関する正本ルールはこの skill に集約する。 AGENTS.md には skill を使うことだけを書き、詳細なレビュー規約はここに置く。

起動時にやること

1. AGENTS.md を読み、リポジトリ共通ルールを確認する
2. 対象記事を読み、方針に沿って校正する
3. 修正は高確度なものだけに絞り、全面リライトはしない

Scope

• 対象は主に blog.jxck.io/entries/**/*.md
• 指示がなければ、本文・見出し・箇条書き・注釈を確認対象とする
• 画像や外部リンクのファクトチェックは、必要性が明示された場合にのみ行う
• 漢字の開き閉じは、明示的に求められない限り触らない
  • 関わらず を かかわらず に修正しない
  • 無い を ない に修正しない
• 同一記事の中で閉じ開きがゆれていたら、閉じる側に揃える

Review Order

• まず明確な誤字脱字を直す
• 次に、意味を変えずに不自然な表現を直す
• 次に、同一記事内の表記ゆれをそろえる
• 次に、長すぎて読みにくい一文だけを分割する
• 最後に、読点(、)の配分を直す
  • 長過ぎる場合、読点を入れて文を分割する
  • 入れる場所のバランスがおかしい場合、適切な場所に修正する

What To Fix

• 明確な「ら抜き言葉」と「い抜き言葉」
• 明確な誤字脱字
• 不自然な日本語
  • 名詞化が連続して重い文
  • 主語述語の対応が弱い文
  • 係り受けが遠すぎる文
  • 口語的すぎて浮く表現
• 表記ゆれ
• 数字
  • 基本は算用数字を使う(一回 -> 1 回)

What Not To Fix

• 筆者の主張やトーンそのもの
• 意図的な言い回し、皮肉、比喩
• 漢字の開き閉じ
• 業界慣用表現
• ファイル末尾に改行を足さない

Sentence Splitting

• 一文が長くても、論理が素直で読めるなら無理に分割しない
• 分割するのは次のような場合のみ
  • 1 文に論点が 3 つ以上入っている
  • 逆接や条件節が重なって読みにくい
  • 補足が長く、主文が埋もれている
• 分割時は、意味やトーンを変えない
• 接続詞を安易に増やしすぎない

Style

• 筆者の文体は維持する
• 技術記事としての硬さは保つ
• 過度に平易化しない
• 説教くさい書き換えや要約はしない
• 意味が同じなら、短くて素直な文を優先する

Output Policy

• 修正は高確度なものだけに絞る
• 大規模な全面リライトはしない