← Back to list

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構文の問題を修正する
- 見出しレベルの適切な階層構造を確保する
- コードブロックに言語指定を追加する
- リストの書式を統一する
- 空行の適切な配置を確認する
校正の手順
- 記事ファイルを読み込む - 指定された記事の全内容を確認
- Linterを実行 -
npx textlint "記事パス"を実行して指摘を確認(最優先) - Linter指摘に対応 - textlint-jaの指摘をすべて修正
- 全体を通読 - 記事全体の流れとトーンを確認
- トーンの一貫性 - 先回りした感じやAIっぽい表現がないかチェック
- 冗長性の確認 - しつこい前置きや不要な説明を削除
- 太字の見直し - 本当に強調すべき箇所だけに絞る
- 構成の確認 - 個人の学習体験として自然な流れになっているか
- 最終確認 - 不自然な箇所や内容の密度バランスをチェック
- 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