明確で簡潔な文章を書く

概要

明確で力強く書きます。このスキルは何をすべきか (Strunk) と何をしてはいけないか (AI パターン) をカバーします。

このスキルをいつ使うか

人間が読む散文を書く際は常にこのスキルを使用してください：

• ドキュメント、README ファイル、技術説明
• コミットメッセージ、プルリクエスト説明
• エラーメッセージ、UI コピー、ヘルプテキスト、コメント
• レポート、サマリー、その他の説明
• 明確さを改善するための編集

人間が読む文を書いているなら、このスキルを使ってください。

限定コンテキスト戦略

コンテキストが限られている場合：

1. 判断を使って下書きを書く
2. 下書きと関連セクションファイルを持つサブエージェントをディスパッチする
3. サブエージェントにコピー編集させて修正版を返させる

すべてを読み込む代わりに単一セクション (~1,000-4,500 トークン) を読み込むことで、かなりのコンテキストを節約できます。

スタイルの要素

William Strunk Jr. の『The Elements of Style』(1918) は、明確に書き容赦なく削る方法を教えています。

ルール

使用法の基本ルール (文法・句読法)：

1. 所有格単数は 's を追加して形成する
2. シリーズの各用語の後にコンマを使用 (最後を除く)
3. 括弧内の表現をコンマで囲む
4. 並列句を導入する接続詞の前にコンマを置く
5. 独立節をコンマで接続しない
6. 文を2つに分割しない
7. 文頭の分詞句は文法的主語を指す

構成の基本原則：

8. トピックごとに1段落
9. トピック文で段落を始める
10. 能動態を使う
11. 陳述を肯定形で述べる
12. 明確で具体的で具体的な言語を使う
13. 不要な言葉を削る
14. だらだらした文の連続を避ける
15. 並列的な考えを同じ形式で表現する
16. 関連する言葉を一緒に置く
17. サマリーでは1つの時制を保つ
18. 強調的な言葉を文末に置く

参考ファイル

上記のルールは Strunk の原文から要約されています。完全な説明と例については：

セクション	ファイル	~トークン
文法、句読点、コンマルール	02-elementary-rules-of-usage.md	2,500
段落構成、能動態、簡潔性	03-elementary-principles-of-composition.md	4,500
見出し、引用、フォーマット	04-a-few-matters-of-form.md	1,000
単語選択、一般的なエラー	05-words-and-expressions-commonly-misused.md	4,000

ほとんどのタスクに必要なのは 03-elementary-principles-of-composition.md のみです — 能動態、肯定形、具体的な言語、不要な言葉の削除をカバーしています。

避けるべき AI ライティングパターン

LLM は統計的平均に回帰し、一般的で膨らんだ散文を生成します。避けるべきもの：

• 大げさな表現: pivotal、crucial、vital、testament、enduring legacy
• 空の "-ing" フレーズ: ensuring reliability、showcasing features、highlighting capabilities
• プロモーション用形容詞: groundbreaking、seamless、robust、cutting-edge
• 使い過ぎの AI 語彙: delve、leverage、multifaceted、foster、realm、tapestry
• フォーマット過剰: 過度な箇条書き、絵文字装飾、全ての単語を太字

具体的で、壮大でないようにしてください。それが実際に何をするのかを言ってください。

これらのパターンが発生する理由に関する包括的な調査については、signs-of-ai-writing.md を参照してください。Wikipedia エディターはこのガイドを AI 生成の投稿を検出するために開発しました — それらのパターンはよく文書化され、現地試験されています。

結論

人間のために書いていますか？ elements-of-style/ から関連セクションを読み込み、ルールを適用してください。ほとんどのタスクでは、03-elementary-principles-of-composition.md が最も重要な内容をカバーしています。