Japanese Clear Writing

日本語の文書を、読み手が見つけ・理解し・使えるように、新規に書く、書き直す、添削する、評価するスキル。

API不要 Python 3 5モード

1. 概要

レポート、提案書、手順書、設計書、メール、社内文書、AI生成文に、分かりやすい日本語のルールを当てるスキルです。メモから新しく書く、意味を変えずに書き直す、問題点を修正案付きで指摘する、6項目のルーブリックで採点する、という4つの使い方があります。

最優先は意味を守ることです。事実、数値、固有名詞、要件、法務・安全上の表現の強さは変えません。情報が足りない所は、値を推測で作らずに [要確認] で示します。

ASD-STE100 の公式日本語版や、何らかの標準への準拠を名乗るものではありません。英語の手順書には ste-writer を使ってください。

「分かりやすく書いて」「書き直して」「添削して」「点数をつけて」といった依頼で動きます。標準名を挙げる必要はありません。

原稿を書き直す例です。

この報告書を読みやすく書き直して。読み手は部長、目的は承認をもらうこと。

点数、直す3点、書き直し版、詳しい指摘をまとめて出す例です。

この手順書をレビューして。

ルーブリックの合計を自分で計算する場合は次のとおりです。

python3 scripts/score.py 4 3 3 5 4 4    # 6項目を表の順に、各0〜5点
python3 scripts/score.py 4 3 - 5 4 4    # 判定材料が足りない項目は -

依頼文と渡された原稿からモードを選びます。依頼にモードの指定があれば、それを優先します。

添削の優先度は次の3段階です。

項目	配点	見ること
目的・構成	20	目的、結論、前提、見出し、情報の順序
文の明瞭さ	20	一文一論点、主語と述語、係り受け、文の長さ
曖昧さ・正確さ	20	曖昧な指示語、程度や時期の表現、二重否定、受け身の多用
用語の一貫性	15	同じ概念に同じ語を使う。専門用語や略語を必要に応じて説明する
読み手適合性	15	想定読者の知識、目的、読む場面に合っている
表記・視認性	10	文体、句読点、数字、単位、文字種、箇条書き、見出しの統一

各項目を0〜5点で採点し、項目点 ÷ 5 × 配点 で換算します。計算は scripts/score.py が行います。- にした項目があると、残りの項目で100点満点に換算し直します。

この点数は、直す順番を決めるためのルールベースの診断です。心理測定や公的な可読性試験ではありません。

ファイルを書き直すときは、元のファイルの隣に新しいファイルを作ります。元のファイルは上書きしません。