Back to list
imudak

japanese-article-proofreading

by imudak

記事など

0🍴 0📅 Jan 25, 2026

SKILL.md


name: japanese-article-proofreading description: 日本語技術記事を校正します。トーン、文体、冗長性、太字の使用、記事構成などをチェックし、改善提案を提示します。ブログ記事の校正を依頼されたときに使用してください。

日本語技術記事の校正スキル

指定された記事ファイルを読み込み、以下のガイドラインに基づいて校正を行い、修正案を提示します。

校正の重点項目

1. トーンと文体の確認

文体は「ですます調」を使用

  • 記事全体を「ですます調」で統一する
  • 「だ・である調」は使わない
  • 例: 「〜です」「〜ます」「〜でした」「〜ました」

先回りして書いた感のある表現を避ける

  • ❌ 「次のような疑問を持つ方もいるかもしれません」
  • ❌ 「という反論もあるでしょう」
  • ✅ 「ここまで理解して、気になったのが〜」
  • ✅ 「さらに疑問が湧いてきました」

AIっぽい表現を避ける

  • ❌ 「あなたの」「あなたが」
  • ❌ 「〜いるんです」「〜だったんですね」(砕けすぎ)
  • ✅ 自然な日本語で、主語を明示しすぎない

不自然な主語の繰り返しを避ける

  • ❌ 「私は思いました」「私は疑問に思いました」
  • ✅ 「ここで気になったのが」「さらに疑問が湧いてきました」

感情の過度な表現を避ける

  • ❌ 「感動しました」「驚きました」
  • ✅ 淡々と事実を述べる

押し付けがましい断定を避ける

  • ❌ 「理解できるはずです」
  • ✅ 「見えてくるかもしれません」

仰々しい表現を避ける

  • ❌ 「新しい地平を切り開く挑戦です」(自分が作ったわけではないツール)
  • ✅ 「バージョン管理に対する考え方が変わりました」

2. 冗長性のチェック

冗長な前置きを削除

  • ❌ 「ここで気になったのが〜という点です。確かに〜があります。しかし調べてみると〜」
  • ✅ 「〜がありますが、以下の点で異なります」

不要な説明文を削除

  • ❌ 「次のようにします」「このように〜使えば」
  • ✅ コード例だけで意味が通じる場合は説明不要

「調べてみると〜わかりました」を簡潔に

  • ❌ 「調べてみると〜ことを設計思想の中心に据えていることがわかりました」
  • ✅ 「〜を設計思想の中心に据えています」

3. 太字の適切な使用

太字にすべきもの

  • 重要な技術用語の初出
  • 本質的な違いや特徴
  • 表内の対比項目

太字にすべきでないもの

  • 「重要なポイント:」「重要な注意点:」などのラベル
  • 説明文中の普通の名詞(「Git側でのブランチ名」など)
  • 対比を示すだけの文(「Gitにもgit reflogがありますが」など)

4. 記事の構成

個人の学習体験として書く

  • 自分が発見した順序で説明する
  • 「先回りして答える」のではなく「自分が疑問に思った流れ」で展開

不要な感想を削除

  • まとめの後に追加の感想文は不要
  • 要点はまとめセクション内で完結させる

実体験を入れる

  • 具体的な体験談を含めることで読者の共感を得る
  • 例: 「私自身、何かあるたびにcommitしてpushする習慣があり...」

防衛的な表現を避ける

  • ❌ 「なぜこれが『新しい地平』なのか」(コメントへの反論に見える)
  • ✅ 「squashとの本質的な違い」(中立的)

事実を簡潔に述べる

  • 不要な「私にとって」などの主観的フレーズを削除
  • 事実だけを述べれば十分

5. Linter指摘への対応

textlint-jaからの指摘

textlintコマンドを実行して指摘を確認(必須)
npx textlint "記事ファイルパス"
  • 日本語の文法、表記ゆれ、冗長表現などの指摘に対応する
  • 技術用語の表記統一を確認する
  • 不自然な助詞の使用を修正する
  • 「述語 + コロン(:)」パターン: AIっぽい英語直訳表現を避ける
    • ❌ 「以下のようにする:」「次の通り:」
    • ✅ 「以下のようにする。」「次の通り。」「重要なポイントは以下の通り。」

markdownlintからの指摘

  • Markdown構文の問題を修正する
  • 見出しレベルの適切な階層構造を確保する
  • コードブロックに言語指定を追加する
  • リストの書式を統一する
  • 空行の適切な配置を確認する

校正の手順

  1. 記事ファイルを読み込む - 指定された記事の全内容を確認
  2. Linterを実行 - npx textlint "記事パス" を実行して指摘を確認(最優先)
  3. Linter指摘に対応 - textlint-jaの指摘をすべて修正
  4. 全体を通読 - 記事全体の流れとトーンを確認
  5. トーンの一貫性 - 先回りした感じやAIっぽい表現がないかチェック
  6. 冗長性の確認 - しつこい前置きや不要な説明を削除
  7. 太字の見直し - 本当に強調すべき箇所だけに絞る
  8. 構成の確認 - 個人の学習体験として自然な流れになっているか
  9. 最終確認 - 不自然な箇所や内容の密度バランスをチェック
  10. Linter再実行 - 修正後に npx textlint "記事パス" で検証

注意事項

  • 個人ブログの記事であることを念頭に置く
  • 教科書やドキュメントではなく、学習の記録として
  • 読者に教えるのではなく、自分の発見を共有する姿勢で
  • 校正の最初と最後に必ずtextlintコマンドを実行する
  • textlint-jaの指摘は必ずすべて対応する(エラー0にする)
  • 修正は一度にすべて行い、Edit toolで反映させる

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon