agent-style

agent-style v0.9.0 — Anthropic Skills アダプター

agent-style は、AI エージェント向けの、文献に基づく英語の技術文書執筆ルールセットです。このアダプターは .claude/skills/agent-style/SKILL.md にある Anthropic Skill です。Claude Code はフロントマターのメタデータを先行してスキャンします。以下の本文は、関連する文章作成タスクでスキルが呼び出されると段階的に読み込まれます。

自己検証ハンドシェイク

「agent-style は有効ですか？」または「ここではどの執筆ルールが適用されますか？」と尋ねられた場合は、次のように回答します。agent-style v0.9.0 active: 21 rules (RULE-01..12 canonical + RULE-A..I field-observed); full bodies at .agent-style/RULES.md.

読み込みに関する説明

Anthropic Skills は、name フロントマターを通じてこの SKILL.md を検出します。フロントマターはセッション開始時に先行してスキャンされ、本文（以下の簡潔な指示を含む）は、関連するタスクでスキルが呼び出されると読み込まれます。Anthropic Skills は2つ目のファイルを自動インポートしません。スキルの呼び出し時にコンテキストへ渡されるのは、以下の簡潔な指示です。

21のルール（簡潔な指針）

標準的なルール（Strunk & White 1959、Orwell 1946、Pinker 2014、Gopen & Swan 1990に基づく）：

• RULE-01 知識の呪い：想定する読者を明確にし、読者が自分の暗黙知を共有していると思い込まないでください。
• RULE-02 受動態：行為者が分かっていて、明示する価値がある場合は、能動態を優先してください。
• RULE-03 具体的な表現：「要因」や「側面」のような抽象的な分類語より、具体的で明確な用語を優先してください。結果の傾向と丸めた規模を示し、差があるかどうかを平易な言葉で述べ、標準偏差、区間、完全な数値は表に記載してください。ノイズの範囲内の差を向上と呼んではいけません。連続する文に数値を詰め込まず、キャプションは表示内容にとどめてください。差は未加工の小数ではなくポイントまたはパーセントで報告し、本文、表、キャプションで単位と符号を統一してください。複数の数値が重要で、まとめて示す表示がない場合は表を追加してください。
• RULE-04 不要な語句：「〜するために」「〜という事実により」「潜在的に〜の可能性がある」のような冗長な表現や、内容を予告するだけの文、手法を言い直す文、知見を繰り返す文は削除してください。要旨では問題とその課題から手法と知見へ進み、結論は短くまとめてください。
• RULE-05 陳腐な比喩：「限界を押し広げる」「パラダイムシフト」「最先端」のような決まり文句は削除してください。
• RULE-06 平易な英語：「レバレッジを効かせる」より「使う」、「方法論」より「方法」、「機能性」より「機能」を優先してください。
• RULE-07 肯定形：「重要でない」より「些細な」、「覚えていなかった」より「忘れた」を優先してください。強調のために「XだけでなくYも」のような「XではなくY」という対比を持ち出さないでください。
• RULE-08 主張の調整：証拠に合わせて動詞を調整してください。証拠が「示唆する」にとどまる場合に「証明する」と書かないでください。主張を変える限定表現は残し、意味のない但し書きは削除してください。
• RULE-09 並列構造：並列する考えは、同じ文法形式で表現してください。
• RULE-10 関連語を近づける：主語を動詞の近くに、修飾語を修飾対象の近くに置いてください。長い挿入句は分割してください。
• RULE-11 強調位置：新しい情報や重要な情報は、文末に置いてください。
• RULE-12 長文：文の長さに変化をつけてください。要点にたどり着くまでに読者が複数の節を頭に留めておく必要がある場合は、文を分割してください。ひとつながりの考えを述べているなら、長文のままでもかまいません。

現場で観察されたルール（2022～2026年のLLM出力に関するメンテナーの観察）：

• RULE-A 箇条書きの多用：考えがつながっている場合は段落で述べ、箇条書きは実際のリストに限ってください。無理に3項目のセットにせず、表のセルには数値または短いラベルを記載してください。
• RULE-B ダッシュの多用：文中の句読点代わりにエムダッシュやエヌダッシュを使わないでください。代わりに、コンマ、コロン、括弧、または文の分割を使ってください。セミコロンは控えめにしてください。
• RULE-C 文頭の繰り返し：連続する2文以上を同じ語で始めないでください。
• RULE-D 接続語：「Additionally」「Furthermore」「In addition」のように追加だけを示す接続語で文を始めないでください。「Moreover」や「Notably」で始める文は、段落内で1文までにしてください。文章ですでに示されている対比、因果関係、順序を表す語（「However」「Thus」「First」など）は残し、文をつなぐためだけに因果関係を付け加えないでください。
• RULE-E 要約の結び：すべての段落を、要点を言い換える文で締めくくらないでください。
• RULE-F 用語の一貫性：用語や略語を定義したら、その後も同じものを使い続けてください。同義語を交互に使わないでください。
• RULE-G タイトルケース：セクション見出しとサブセクション見出しではタイトルケースを使ってください。冠詞と短い前置詞は小文字のままにします。文全体を太字にしたリード文には、文頭のみ大文字の表記を使ってください。
• RULE-H 引用の規律（重要）：事実に関する主張は、検証可能な引用または具体的な証拠で裏付けてください。引用を捏造してはいけません。
• RULE-I 短縮形：技術的な文章では、形式を重んじる場合、「it's」「doesn't」「can't」より「it is」「does not」「cannot」を優先してください。

例外規定

「あからさまに野蛮なことを言うくらいなら、これらの規則を破りなさい。」 — George Orwell、「Politics and the English Language」（1946年）、規則6。ほとんどの規則は、判断を加えて適用するためのデフォルトです。文章がよりよく読めるようになる場合に逸脱してください。パターンに変化をつけるためだけに逸脱してはいけません。いくつかは厳守すべき規則です（引用、根拠、数値を捏造しないこと。完成した文章にプレースホルダーを残さないこと）。草稿は全体的なパターンで判断してください。すべての文ですべてのデフォルトに従うと、機械が書いたように読めてしまいます。

ハウススタイル

規則は古典的なガイドを出発点とし、特定の著者である Yue Zhao 向けに調整されています。RULES.md の「ハウススタイル」セクションには、AI ライティングツールが登場する前に筆頭著者として執筆した機械学習論文から読み取った、その著者の習慣が記載されています。要旨、序論、結果の段落、結論の構成、4文に1文ほどが30語を超え、括弧内に補足説明を添えること、道しるべとなる表現を控えめに使うことなどです。スタイル規則とその習慣が矛盾する場合は、その習慣に従ってください。ただし、事実や厳守すべき規則に反してはいけません。論文や提案書のセクションを執筆する前に、RULES.md の該当セクションを読んでください。

規則の全文（正式版）

各規則の指示全文、BAD/GOOD の例、および根拠については、このプロジェクトの .agent-style/RULES.md、または固定された正式版ソースである https://raw.githubusercontent.com/yzhao062/agent-style/v0.9.0/RULES.md を参照してください。