AIチュートリアル

sepiaでより人間らしい文章を書く・レビューする・リファクタリングする

このチュートリアルでは、Claude Code、Codex、Grok Build、Antigravityにsepiaをインストールし、執筆、レビュー、リファクタリング、再構成の各操作を適用する方法を説明します。3パスのフィクション執筆ワークフロー、媒体別のプロ向けルール、診断オプション、プロジェクト単位のセットアップ、実践的な調整方法を学べます。

2026年8月28日約14分で読了

sepiaとは？

sepiaは、AI支援によるフィクションやプロフェッショナル向け文章の品質を高める、ポータブルなAgent Skillです。1つの正規のSKILL.mdでClaude Code、Codex、Grok Build、Antigravityに対応し、プラットフォームごとに個別の指示を用意する必要がありません。

語彙や文の構文に集中するツールとは異なり、sepiaは文章を機械生成らしく感じさせる構造的パターンから検討します。フィクションでは、整いすぎた因果関係、語り手によるテーマの説明、直線的な時間展開、限られた感情表現、現実世界への言及の欠如、成長や受容だけで完全に解決される結末などが対象になります。

プロフェッショナル向け文書では、sepiaは異なる問題を探します。情報のない冗長表現、不要な婉曲表現、チャットボットの痕跡、不適切な文体、反復的な書式、文書が掲載される場に求められる期待への不適合などです。

基本原則：認識したAIらしさを機械的にすべて反転させるのではなく、人間の文章に見られる分布へ向けて文章を調整する。

主な機能

4つの文章操作

sepiaには、下書きの異なる段階に適した4つの操作があります。

write：該当するフィクションまたはプロフェッショナル文章のルールを使って、新しい文章を作成します。
review：文章を編集せずに問題を診断します。
refactor：下書きをできる限り維持しながら、最小限の対象を絞った編集を行います。
recreate：局所的な編集では不十分な場合に、内容を完全に書き直します。

3パスのフィクション用プロトコル

物語の設計：テーマの説明、因果関係の整いすぎ、明かすタイミング、感情の表現形式、登場人物同士のネットワーク、現実の事物への言及を扱います。
語りの流れ：反復的な段落と質問の型を崩し、物語中盤の停滞を修正し、リズムと情報の配置に変化をつけます。
表層の文体：より大きな構造上の問題に対処した後で、決まり文句、構文の型、語彙、文体を見直します。

このスキルには、フィクションを30の特徴から診断する評価基準と、Claude、GPT、Gemini、DeepSeek、Kimiに関連するパターンへの修正方法も含まれています。

プロフェッショナル文書のルール

プロフェッショナル向け文章では、共通チェックリストに加え、対応する各媒体向けの簡潔なルールファイルを使用します。

リリースノートと告知：ユーザーへの影響を最初に示し、成果物で主張を裏付け、マーケティング的な誇張を避けます。
プルリクエストとIssueへの返信：最初に答えを示し、file:lineを引用し、反射的な称賛を避け、重要度に応じた長さにします。
ポストモーテム：人に対しては責任を追及せず、仕組みを厳密に検証します。タイムスタンプ、行き詰まった経緯、担当者が明確なアクションアイテムを含めます。
チケットと作業指示書：タイトルで成果を示し、検証可能な受け入れ条件を記載し、情報を繰り返す代わりにリンクします。
技術記事：問題から始め、実際の行き詰まりを1つと、明確な持論を1つ含め、数値には前提条件を付けます。

sepiaのインストール

デフォルトのインストール範囲はユーザーアカウントなので、1回のインストールを複数のプロジェクトで使用できます。利用するエージェントプラットフォームの手順を選んでください。

Claude Code

# install
claude plugin marketplace add Nanako0129/sepia
claude plugin install sepia@sepia --scope user

# update
claude plugin marketplace update sepia
claude plugin update sepia

Claude Codeのセッション内プラグインダイアログからインストールする場合は、範囲を尋ねられたときにUserを選択してください。

Codex

# install
codex plugin marketplace add Nanako0129/sepia
codex plugin add sepia@sepia

# update
codex plugin marketplace upgrade sepia
codex plugin add sepia@sepia

Codexを更新するには、マーケットプレイスのスナップショットを更新してから、プラグインを再度追加して新しいバージョンを取得する必要があります。

Grok Build

# install
grok plugin install Nanako0129/sepia --trust

# update
grok plugin update

Grok Buildは、既存のClaude Codeへのsepiaのインストールも自動的に検出できます。

Antigravity

Antigravityはこのスキルにマーケットプレイスを使用しません。リポジトリをクローンし、スキルディレクトリをコピーして、グローバルな/sepiaワークフローをインストールしてください。

# install
git clone https://github.com/Nanako0129/sepia.git ~/.sepia
mkdir -p ~/.gemini/config/skills ~/.gemini/antigravity/global_workflows
cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

# update
git -C ~/.sepia pull
rm -rf ~/.gemini/config/skills/sepia && cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

4つすべてのプラットフォームにインストール

このリポジトリには、対応する4つのプラットフォームすべてにsepiaをユーザー範囲でインストールするスクリプトが用意されています。

curl -fsSL https://raw.githubusercontent.com/Nanako0129/sepia/main/install.sh | bash

このスクリプトはプロジェクトを~/.sepiaにクローンします。別の場所を使うにはSEPIA_HOMEを設定してください。同じコマンドをもう一度実行すると、インストールが更新されます。実行前にスクリプトを確認するには、リポジトリをクローンし、チェックアウト先で./install.shを実行してください。

Skills CLIでインストール

Skills CLIはsepiaを導入する別の方法で、77以上のエージェントに対応しています。

npx skills add Nanako0129/sepia -g
npx skills update -g

-gオプションはユーザー範囲を選択します。指定しない場合、CLIはデフォルトでプロジェクト範囲を使用します。

基本的な使い方

インストール後、エージェントに sepia を適用し、4つの操作のいずれかを指定してください。以下の例は、プラットフォーム固有のシェルコマンドではなく、依頼文の例を示したものです。

新しいドキュメントを書く

簡単な依頼から始める場合は write を使います。sepia が適切なルールを選べるよう、対象となる文書の種類を明示してください。

sepia の write 操作を使い、以下の変更からリリースノートを作成してください。
ユーザーへの影響を最初に示し、各主張を具体的な成果物で裏付けてください。

フィクションでは、構成上のすべての動きを指定するのではなく、前提、制約、意図する形式を提示します。

sepia の write 操作を使い、この前提から短編小説を作成してください。
フィクション用プロトコルを適用しつつ、曖昧さを残し、テーマを説明しないでください。

原稿を変更せずに診断する

修正内容を決める前に指摘が欲しい場合は review を選びます。元の原稿に手を加えないよう、診断だけを明示的に依頼してください。

sepia でこの物語をレビューしてください。診断だけを行い、書き直さないでください。
物語の構造を優先し、次に談話の流れ、最後に表層的な文体を確認してください。

専門的なドキュメントでは、その種類を明記します。

sepia でこのインシデント事後分析をレビューしてください。
タイムスタンプ、行き止まり、メカニズム分析、担当者が明確なアクション項目を確認してください。
原稿を編集しないでください。

最小限の変更を加える

原稿が基本的に適切で、可能な限り声、事実、構成を維持したい場合は refactor を使います。

sepia でこの技術記事を最小限の編集でリファクタリングしてください。
技術的な主張と文体を維持しながら、冗長な部分を削り、対象媒体との不一致を修正してください。

ゼロから書き直す

局所的な編集では構造上の問題をきれいに解決できない場合は recreate を使います。

sepia でこのリリース告知を再作成してください。
確認済みの事実をすべて維持し、ユーザーへの影響を最初に示し、マーケティング上の誇張を削除してください。

再作成は全面的な書き直しなので、残す必要がある事実、引用、参照、制約を明示してください。

適切な操作を選ぶ

元となる資料や依頼はあるものの、使える原稿がない場合は write を選びます。
変更を加えずに診断、編集計画、セカンドオピニオンが必要な場合は review を選びます。
まったく新しい構成にすることより、既存の原稿を維持することが重要な場合は refactor を選びます。
原稿の構造、構成、文体が根本的に不適切な場合は recreate を選びます。

応用のヒント

フィクションのルールをすべて適用しない

sepia は、物語に役立つおよそ3〜5個の手法を選び、それ以外には余白を残すよう設計されています。すべての修正を適用すると、ある特徴的なパターンが別のパターンに置き換わるだけになることがあります。ルールの適用範囲を最大化するのではなく、最も影響の大きい指摘を優先するようエージェントに依頼してください。

sepia でこの物語をレビューし、影響の大きい問題を5つ特定してください。
上位3つだけをリファクタリングし、意図的な不規則さは残してください。

構造の順序に沿って改稿する

フィクションでは、物語の構造を確定する前に文章を磨くことは避けてください。まず構造をレビューし、談話の流れを修正し、その後で表層的な文体を調整するのがよい順序です。これにより、大規模な改稿の際に文単位の洗練が無駄になるのを防げます。

媒体と根拠を提示する

専門的な文章のルールは文脈によって異なります。原稿がチケット、プルリクエストへの返信、事後分析、リリースノート、技術記事のいずれなのかを sepia に伝えてください。関連するファイル、行参照、タイムスタンプ、受け入れ条件、リンク、測定値、条件を含めると、出力を具体的なものに保てます。

sepia をプロジェクトに固定する

リポジトリに既知のスキルのコピーを保持させる必要がある場合は、プロジェクトスコープを使います。Codex と Antigravity では skills/sepia/ を .agents/skills/sepia としてコミットし、Claude Code では .claude/skills/sepia としてコミットしてください。

この方法は、各コントリビューターのユーザースコープのインストールに依存せず、リポジトリ自体に独自のスキルバージョンを持たせたいチームに適しています。

参照レイヤーを確認する

正規のスキルは skills/sepia/SKILL.md にあります。参照ファイルでは、物語の構造、談話の流れ、表層的な文体、診断、モデルの指紋、共通の専門的ルール、媒体固有の分野が分けられています。research/ ディレクトリには、プロジェクトで整理された根拠の基盤とソースリンクがあります。

インストールを最新に保つ

選択したプラットフォーム用の更新コマンドを使ってください。install.sh ですべてのプラットフォームをインストールした場合は、同じインストールコマンドを再実行します。Antigravity の手動セットアップでは、リポジトリを取得し、更新されたスキルファイルとワークフローファイルを再度コピーする必要があります。

まとめ

sepia は、人間らしい文章を単なる語彙の問題として扱いません。フィクションのワークフローでは、物語の構造から始め、談話の流れを経て、表層的な文体で仕上げます。一方、専門的な文章のルールは、特定の文書種別に期待される内容に応じて適応します。ユーザースコープまたはプロジェクトスコープにインストールし、編集の目的に合った操作を選び、利用可能なすべてのルールではなく、影響の大きい変更を少数適用してください。

sepia は MIT License の下で公開されています。ソース、参照ファイル、インストールスクリプト、調査資料のダイジェストは、GitHub リポジトリで利用できます。