mcpField
W
writing-clearly-and-concisely

writing-clearly-and-concisely

github.com/softaworks生産性2.6k4.3k 回インストール34 週間前に更新
リポジトリ

writing-clearly-and-concisely について

writing-clearly-and-conciselyは、ドキュメントやUIコピーからレポート、要約まで、人向けの文章を書く人を対象としたスキルです。Strunkの文体原則を用い、避けるべきAI文章の典型的なパターンも示します。

主な機能

  1. 01文法と句読点のルールを適用
  2. 02能動的で具体的な表現
  3. 03不要な語句の削除
  4. 04段落構成の改善
  5. 05AI文章にありがちな表現の回避

活用シーン

  1. 01技術説明の編集
  2. 02プルリクエストの説明文の明確化
  3. 03UIコピーやエラーメッセージの改善
  4. 04レポートや要約の簡潔化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/softaworks/agent-toolkit --skill writing-clearly-and-concisely

インストール後、Claude Code で/writing-clearly-and-conciselyを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
signs-of-ai-writing.md
elements-of-style/
01-introductory.md
02-elementary-rules-of-usage.md
03-elementary-principles-of-composition.md
04-a-few-matters-of-form.md
05-words-and-expressions-commonly-misused.md

詳細

明確で簡潔な文章の書き方

概要

明確で力強い文章を書きます。このスキルでは、何をすべきか（Strunk）と、何を避けるべきか（AI 特有の文体パターン）を扱います。

このスキルを使う場面

人間向けに文章を書くときは、常にこのスキルを使ってください。

  • ドキュメント、README ファイル、技術的な解説
  • コミットメッセージ、プルリクエストの説明
  • エラーメッセージ、UI の文言、ヘルプテキスト、コメント
  • レポート、要約、その他あらゆる説明
  • 明確さを高めるための編集

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

コンテキストが限られている場合の戦略

コンテキストに余裕がないときは、次の手順で進めてください。

  1. 判断に基づいて下書きを書く
  2. 下書きと関連するセクションファイルを添えてサブエージェントを呼び出す
  3. サブエージェントに推敲を依頼し、修正版を返してもらう

すべてを読み込むのではなく、1 つのセクション（約 1,000〜4,500 トークン）だけを読み込めば、コンテキストを大幅に節約できます。

文体の要素

William Strunk Jr. の The Elements of Style（1918 年）は、明確に書くことと、無駄を容赦なく削ることを教えています。

規則

基本的な用法の規則（文法・句読法）:

  1. 単数の所有格は 's を付けて作る
  2. 列挙では、最後の項目を除き、各項目の後にコンマを付ける
  3. 挿入句はコンマで挟む
  4. 等位節を導く接続詞の前にコンマを置く
  5. 独立節をコンマだけで繋がない
  6. 一つの文を二つに分けない
  7. 文頭の分詞句は、文の文法上の主語を修飾する

基本的な構成の原則:

  1. 一つの話題には一つの段落を充てる
  2. 段落は話題文で始める
  3. 能動態を使う
  4. 文は肯定形で書く
  5. 定義的で具体的、具象的な言葉を使う
  6. 不要な語を省く
  7. 緩い文が連続しないようにする
  8. 同等の観念は同じ形式で表現する
  9. 関連する語は近くに置く
  10. 要約では時制を一つに保つ
  11. 強調したい語は文末に置く
参考ファイル

上記の規則は Strunk の原文を要約したものです。例を交えた完全な説明は、次のファイルを参照してください。

セクションファイル約トークン数
文法、句読法、コンマの規則02-elementary-rules-of-usage.md2,500
段落構成、能動態、簡潔さ03-elementary-principles-of-composition.md4,500
見出し、引用、書式04-a-few-matters-of-form.md1,000
語の選択、よくある誤用05-words-and-expressions-commonly-misused.md4,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 が最も重要な内容を扱っています。

コメント

Markdown 対応