日本語Markdownドキュメントの校正スキル

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

校正の重点項目

1. トーンと文体の確認

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

• •ドキュメント全体を「ですます調」で統一する
• •「だ・である調」は使わない
• •例: 「〜です」「〜ます」「〜でした」「〜ました」

AIっぽい表現を避ける

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

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

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

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

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

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

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

仰々しい表現を避ける

• •❌ 「新しい地平を切り開く挑戦です」
• •✅ 「考え方が変わりました」

2. 冗長性のチェック

冗長な前置きを削除

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

不要な説明文を削除

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

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

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

3. 太字の適切な使用

太字にすべきもの

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

太字にすべきでないもの

• •「重要なポイント:」「重要な注意点:」などのラベル
• •説明文中の普通の名詞
• •対比を示すだけの文

4. 文書の構成

不要な感想を削除

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

防衛的な表現を避ける

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

事実を簡潔に述べる

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

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で反映させる