clear-writing について
明確な構成、一般的な語彙、簡潔な文で説明を理解しやすくするライティングスキルです。事実や不確実性、書き手の文体を保った文章が必要な場合に適しており、ASD-STE100への厳密な準拠には公式資料の確認が必要です。
主な機能
- 01読者の疑問を特定
- 02要点から説明
- 03一般的な語彙と能動態を優先
- 04用語の一貫性を維持
- 05文と段落を簡潔化
- 06文体を参考にした草稿と準拠確認を区別
活用シーン
- 01難解な説明文の書き換え
- 02手順や指示の明確化
- 03ASD-STE100を参考にした草稿の作成
- 04厳密なSTE要件の確認
MCP 対応
入力にはMCP連携についての記載がありません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/clear-writingを入力して読み込まれたか確認します。
同梱ファイルreferences/asd-ste100.md
詳細
明確な文章
読者が文章を解読せずに理解できるように説明します。 Karpathy の提案に従い、「ASD-STE100 の 80% を達成する」ことを目指します。 この表現は文体の好みを示すものであり、準拠度のスコアではありません。
正確な規格、例、およびツイートに添付された画像への修正については、標準の参考資料をお読みください。 基準とするのは ASD-STE100 Simplified Technical English, Issue 9 (2025-01-15) です。
デフォルト：読みやすく、STE に着想を得た文章
- 読者の疑問と、それに答える事実を特定します。
- 要点を先に伝え、役立つ順序で説明を組み立てます。
- 一般的な語、具体的な主語、能動態の動詞を使います。必要な用語は定義します。
- 概念ごとに名称をひとつに統一します。飾りのための同義語や決まり文句は取り除きます。
- 説明文は 1 文あたり 25 語以下、指示文は 20 語以下を目指します。段落ではひとつの話題を扱い、6 文を超える段落は分割します。
- 1 文につき指示はひとつにします。操作の前に前提条件を示します。長い名詞のまとまりは、各要素の関係がわかる表現に分けます。
- 不要な語を取り除いてから、意味を確認します。事実、不確実性、単位、例外、およびユーザーの語り口は保ちます。自然な表現が役立つ場合は、それを維持します。
依頼されたテキストを返します。編集についての説明は、役立つ場合、または求められた場合にのみ加えます。
ユーザーが厳密な ASD-STE100 を求める場合
指定された版の公式コピーで、該当するライティングルールと辞書を確認します。そうでない場合は、公式サイトで更新情報を確認してから Issue 9 を使います。 ユーザーの専門分野または承認済み用語集から、技術的な名詞と動詞を特定します。 単語は、承認された意味、品詞、および使用可能な形に基づいて確認します。 規格の語数の数え方を含め、手順を説明する文章または描写する文章に応じたルールを適用します。参考資料のルールマップを使って、該当する節を探します。
公式のルール、辞書、または必須の用語を参照できない場合は、STE に着想を得た草案であることを明記し、未確認の項目を示します。厳密な検証が必要な場合は、不足している参考資料を求めます。短い文、モデルの記憶、または添付画像を根拠に、準拠していると主張してはいけません。厳密な草案の場合は、使用した版と完了した確認項目を報告し、草案の作成と準拠の検証を区別します。
例
変更前：「作業前に、オペレーターがバルブを確実に閉じていることが不可欠です。」
変更後：「作業を開始する前に、バルブを閉じてください。」
これは文体の例であり、文書全体が規格に準拠しているという主張ではありません。