orwell-writing について
Orwell の文章規則と ASD-STE100 の指針を、執筆と推敲に適用するスキルです。技術文書やビジネス文を明確にしつつ、創作で意図された文体も保ちます。
主な機能
- 01直接的で簡潔な表現の指針
- 02能動態と明確な主語
- 03用語の一貫性
- 04技術説明の書き方
- 05推敲の手順
- 06意図的な創作の文体を維持
活用シーン
- 01技術説明の執筆
- 02ビジネス文や製品文の編集
- 03曖昧で誇張した表現の削除
- 04創作の文体を保った推敲
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/orwell-writingを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlREADME.md
詳細
Orwellの文章作法
概要
OrwellのルールとASD-STE100 Simplified Technical English（STE）を、明快で直接的、かつ誠実な文章を書くための実践的な基準として使用します。技術文書、手順書、ビジネス文書、製品関連の文章では、通常STEを使用します。草稿の作成にも改訂にもこれらのルールを適用します。ただし、ユーザーが明確に求めている場合は、意図的な文体、個性、リズム、ユーモア、ジャンルの特徴を損なわないようにします。
STEには、執筆ルールと管理された辞書があります。辞書を利用できる場合は、承認された語を承認された意味で使用します。ASD-STE100の最新版と辞書を確認せずに、STEに厳密に準拠していると主張しないでください。
基本ルール
「Politics and the English Language」の次のルールを覚えておいてください。
- 印刷物で見慣れた比喩、直喩、その他の修辞表現は使わないでください。
- 短い語で足りる場合は、長い語を使わないでください。
- 削除できる語は、必ず削除してください。
- 能動態を使える場合は、受動態を使わないでください。
- 日常的な英語で言い換えられる場合は、外国語の表現、科学用語、専門用語を使わないでください。
- あからさまに野蛮なことを言うくらいなら、これらのルールを破ってください。
ASD-STE100の基本
技術文書や手順書では、次のルールに従ってください。
- 文を短くしてください。各文には、主要な動作または記述を1つだけ含めてください。
- 明確な主語と能動態の動詞を使ってください。行為者が重要な場合は、行為者を明示してください。
- 同じものには同じ用語を使ってください。繰り返しを避けるためだけに用語を変えないでください。
- 意味が明確な、なじみのある語を使ってください。慣用表現、俗語、比喩表現、曖昧な動詞は避けてください。
- 正確さのために必要な場合は、具体的な技術用語を使ってください。その用語を定義するか、定義へのリンクを付けてください。
- 名詞句は短くしてください。用語間の関係を示すには、前置詞を使ってください。
- 手順は直接的な指示として書いてください。条件、動作、期待される結果を明示してください。
- 明確に伝わる場合は、肯定形の指示を使ってください。読者が行うべきことを示してください。
- ユーザーのスタイルガイドで別の英語の種類が指定されていない限り、アメリカ英語の綴りに統一してください。
- コード、コマンド、識別子、製品名、法的文言、必須の引用はそのまま保持してください。黙って簡略化しないでください。
STEに厳密に従えない場合は、文章を明確に保ち、分野固有の例外が必要な用語や箇所を示してください。
ワークフロー
ゼロから文章を書く場合：
- ユーザーの依頼から、対象読者、目的、求められる文体を特定します。
- 具体的で直接的な英語で草稿を書きます。
- ありきたりな表現、使い古された比喩、埋め草、もったいぶった言い回し、不必要な抽象表現、避けられる専門用語を削除します。
- 強調、配慮、緊張感、技術的な正確さのために受動態が適している場合を除き、能動態の動詞と明確な主語を優先します。
- 必要なニュアンスは保ってください。短くするためだけに、文章を粗雑、不正確、平板にしないでください。
- ASD-STE100の基本を適用します。用語、文の構造、指示、技術的な例外を確認してください。
既存の文章を改訂する場合：
- ユーザーの意図と、明示された文体や書式の制約を保ってください。
- 役割を果たしていない語句、節、文を削除してください。
- 古びた比喩表現は、平易な言い回しか、新鮮で具体的な表現に置き換えてください。
- 正確さを損なわない場合は、長い語、外国語、科学用語、専門用語を日常的な語に置き換えてください。
- 行為者が重要で、特定できる場合は、受動態を能動態に変えてください。
- 必要な専門用語、受動態、華美な表現が残る場合は、重要な正確さを黙って損なうのではなく、その必要性を示してください。
- 最後にSTEの観点から確認してください。各技術用語が一貫していること、各指示に必要な動作が示されていること、各例外に意図があることを確認してください。
創作
小説、詩、回想録、脚本、抒情的な散文では、STEを明瞭さを高めるための手段として扱い、ユーザーの表現形式に優先する要件とはしないでください。意図的な曖昧さ、リズム、会話のスタイル、イメージ、そして実際に効果を生み出している人物の声は保ってください。受け継がれたような表現、誇張された表現、言い逃れの表現、または手抜きに感じられる言葉だけを取り除いてください。ユーザーが明示的に求めた場合は厳格なSTEを使用し、その要望が創作上の効果と相反するときは、その旨を伝えてください。