unai

_{均一に刷られた文章の中から必要な箇所だけを直し、書き手の声を戻す世界を表しています。}

unai

日本語 · English

AIが書いた日本語に、書き手を戻す。 unaiは、AI文章の癖を診断し、文章全体を書き直さず、該当箇所だけを最小修正するagent skillです。Claude Code、Codex、Grok、Cursorで動きます。

kitepon.dev所属のクオが開発・運営しています。

現在のreleaseは unai 0.4.0 です。

30秒でできること

/unai review 下書き.md        # 問題箇所を診断する。文章は変更しない
/unai refactor 下書き.md      # 該当箇所だけを最小修正する
記事を書いて。unaiに従って     # 執筆時から規範を適用する

reviewは根拠と逐語引用を返し、refactorは指摘した箇所だけを直します。全文を別の文章へ作り替えないので、元の主張、情報、構成、書き手の癖を残せます。

なぜ日本語専用なのか

英語圏の同種ツールは、英語のAI文章に現れる癖を対象にしています。日本語には別の語彙、構文、距離感、感情表現があるため、英語向けの規則を翻訳せず、日本語の実例から校正规範を作っています。

	unai	sepia	humanizer
対象言語	日本語	英語	英語
直し方	診断→最小修正（書き直さない）	3段パス（小説は構造から）	35パターンの除去
書き手の声	声の設定で利用者ごとに差し込む	なし	文体サンプルで調整
執筆時の適用	あり（write）	あり	なし

言い換え集ではなく、原因から直します。AIっぽさの根は「書き手の不在」——平均的で、賭けず、読者を信じず、感情を記号で演技する文章になること。unaiはその現れ方（指紋）を診断し、該当箇所だけを最小限で直します。

何を指紋と見なすか（抜粋）

「XではなくY」式の、否定の持ち出しの常用
英単語・識別子を日本語の文に刺し込む（1語ずつは正当でも、密度で文章が死ぬ）
「正直に言うと」「実は」式の保険の前置き
体言止めの乱発・ダッシュの溜め・雑誌ノリのキメ
「側」「層」「〜寄り」のような位置に寄せた歪んだ語彙
毎回同じ段落構成・毎段落末の絵文字・均一なぼかし語尾
「今後の動向に注目です」式のまとめの定型
「〜だけ」「ちょっと」式の矮小表現や偽の謙遜で、設計した成果を小さく見せる
書き手が語っていない体験・感想を作って書く

全文は skills/unai/references/core-pass.md。

同時に「直しすぎ」も指紋と見なします。禁則を全部守った均質な文章は、新しい不在です。unaiは最小修正を原則にします。

インストール

Claude Code

claude plugin marketplace add kitepon/unai

続けて対話中に /plugin からunaiをインストールするか:

claude plugin install unai@unai

Codex / Grok / Cursor（Claude Codeでも可）

curl -fsSL https://raw.githubusercontent.com/kitepon/unai/main/install.sh | bash

Windows nativeではPowerShell 7から実行します。

irm https://raw.githubusercontent.com/kitepon/unai/main/install.ps1 | iex

Claude Code、Codex、Grok、Cursorの4つの部品置き場（~/.claude/skills/unai 等）へ繋ぎ込みます。更新は同じ1行の再実行です。

Codexは公式のuser skill面~/.agents/skills/unaiだけへ配置します。旧Codexで~/.codex/skills/unaiが必要な場合だけ、取得済みinstallerを--profile legacy（Windowsは-Profile legacy）付きで実行してください。公式面と旧面は同時に配置しません。

macOS / Linuxで旧面を明示する例:

bash "${XDG_DATA_HOME:-$HOME/.local/share}/unai/install.sh" --profile legacy

Windowsで旧面を明示する例:

& "$env:LOCALAPPDATA\unai\install.ps1" -Profile legacy

外すときは、導入したOSの入口を使います。skillとCLIの繋ぎ込みだけを外し、取得したrepoは残します。

macOS / Linux:

bash "${XDG_DATA_HOME:-$HOME/.local/share}/unai/install.sh" --uninstall

Windows（上の1行で導入した場合）:

& "$env:LOCALAPPDATA\unai\install.ps1" -Uninstall

手元のcloneから導入した場合は、そのcloneにあるinstall.sh --uninstallまたはinstall.ps1 -Uninstallを実行してください。現在のinstallerは、そのcloneを指しているskillとCLIだけを外します。同じ所有権判定を備えた別versionのcloneから最新版へ張り直した後なら、古いclone側のuninstallで現在の配線は消えません。

この判定を含まない過去tagのinstallerを使う場合は、実行前にskillとCLIのリンク先を確認してください。すでに別cloneを指しているなら、その過去installerでuninstallせず、残った過去cloneだけを削除します。

「実ファイルがあるため上書きしない」と出たとき

installerは、skillの配置先やCLIの配置先に通常のファイル／ディレクトリがあると、それを消さずに保持します。配布bundleと一致しないskillや利用者のCLIが残れば、診断JSONを出して非0終了し、成功とは表示しません。まず表示された対象が自分の資産かを確認し、必要なら名前を変えて退避してからinstallerをもう一度実行してください。リンクやジャンクションならLinkType／Targetも確認できます。

macOS / Linuxの例:

ls -ld ~/.agents/skills/unai ~/.local/bin/unai
unai_conflict="$HOME/.agents/skills/unai"
mv "$unai_conflict" "$unai_conflict.before-unai"
curl -fsSL https://raw.githubusercontent.com/kitepon/unai/main/install.sh | bash

Windowsの例:

Get-Item -Force "$HOME\.agents\skills\unai", "$HOME\.local\bin\unai.ps1" |
  Format-List FullName, LinkType, Target, Attributes
$unaiConflict = "$HOME\.agents\skills\unai"
Move-Item -LiteralPath $unaiConflict -Destination "$unaiConflict.before-unai"
irm https://raw.githubusercontent.com/kitepon/unai/main/install.ps1 | iex

競合しているのがCLIなら、同じ手順で~/.local/bin/unai（Windowsは~/.local/bin/unai.ps1）を退避します。退避物を削除するか統合するかは、中身を確認してから決めてください。

installerはunai CLIも~/.local/binへ配置します。版数と工場向けread-only診断は次の入口です。

unai --version
unai factory-diagnostics --json

工場向けread-only診断の契約

factory-diagnostics --jsonは、unai自身のmanifest・実行環境・skill bundleと4ホストへの投影を読む診断入口です。成功・不成功のどちらでも、診断が実行できた場合はstdoutへ1行のJSONを返します。legacy Codex面を使う場合は--profile legacyを加えます。

{
  "schema": "unai.native_factory_diagnostics.v2",
  "product": { "name": "unai", "version": "0.4.0" },
  "checks": {
    "manifest_consistency": "pass",
    "node_runtime": "pass",
    "skill_bundle": "pass",
    "skill_projections": {
      "claude": "ready",
      "codex": "ready",
      "grok": "ready",
      "cursor": "ready"
    }
  },
  "overall": "ready"
}

top-level fieldはschema、product、checks、overallの4つだけです。

field	契約
`schema`	常に`unai.native_factory_diagnostics.v2`
`product`	`name`は`unai`、`version`はplugin manifestのSemVer
`checks`	3つの製品checkと`skill_projections`
製品checkのstatus	`pass`または`fail`。top-levelの`status` fieldはありません
projectionのstatus	各hostは`ready`、`missing`、`stale`、`conflict`のいずれか
`overall`	3つの製品checkが`pass`かつ4面が`ready`なら`ready`、それ以外は`not_ready`

manifest_consistency: plugin manifestとmarketplace manifestの名前・版数・sourceが一致している
node_runtime: 実行中のNode.jsがpackage.jsonのengines.node（現在は>=22.13）を満たす
skill_bundle: 配布に必要なskill本体と参照文書を読める
skill_projections: Claude Code、Codex、Grok、Cursorの配置先が現在のbundleを使っている

projectionは、この製品bundleを直接指すsymlink／junction、または内容が完全一致するdirectory copyだけがreadyです。配置先がなければmissing、実体directoryの内容が古いかdangling linkならstale、通常file、別bundleへのlink、Codexの公式面とlegacy面の同居はconflictです。絶対pathはJSONへ出しません。

exit	stdout / stderr	意味
`0`	stdoutに診断JSON	`overall: "ready"`
`1`	stdoutに診断JSON	`overall: "not_ready"`
`2`	stderrにusage、診断JSONなし	引数が不正

この診断は校正対象の文章、利用履歴、絶対path、secretを読み取りも出力もしません。

使い方

/unai review 下書き.md        # 診断だけ（編集しない）
/unai refactor 下書き.md      # 該当箇所だけ最小修正
記事を書いて。unaiに従って     # 執筆時に最初から適用

AIからも呼べます。文章を書く作業の中で「unaiに従う」と指示されれば、AIが自分の出力に適用します。

適用範囲は3段階から選ぶ

使う時だけ（既定）: 導入しただけでは何も起きません。上の使い方のように呼んだ時だけ働きます
特定のプロジェクトだけ常時: そのプロジェクトの指示ファイルに下の1行を書くと、そのフォルダでの作業だけ言わなくても常時効きます。ブログのrepoにだけ効かせたい、といった使い方はこれです
全部に常時: ホストの共通指示に同じ1行を足すと、そのAIの全ての文章仕事に効きます

文章・返答の文体はunai skillの規範に従う。

1行を書く場所（ホスト別）:

ホスト	プロジェクトだけ（2）	全部（3）
Claude Code	`CLAUDE.md`	`~/.claude/CLAUDE.md`
Codex	`AGENTS.md`	`~/.codex/AGENTS.md`
Grok Build	`AGENTS.md`	`~/.grok/rules/AGENTS.md`
Cursor	`AGENTS.md` または `.cursor/rules/`	`~/.cursor/rules/` の規則ファイル

置き場はホストの版によって変わることがあります。合わない場合は、そのホストの説明書で「指示ファイル／ルールファイル」の場所を確認してください。

声の設定（voice profile）

AIっぽさを消した後に「どんな声で書くか」はあなた自身のものです。~/.unai/voice.md（プロジェクト固有なら .unai/voice.md）に一人称・語尾・固有の禁句・許す崩しを書いておくと、unaiはそれを核より優先します。

# 私の声
- 一人称は「俺」。読者へ向けた告知は「です・ます」基調で、
  文体は自分の過去の投稿を手本にする。
- 読者は技術に詳しくない人も含む。専門用語は日本語の動きで説明する。
- 軽い冗談は可。

語尾の規則は字面だけで渡さず、自分の実際の文章を手本として指してください。「です・ますで書かない」とだけ教わったAIは、短い言い切り文を連ねた別の演技へ倒れます。書き方の詳細は skills/unai/references/voice-profile.md。

仕組み

flowchart LR
    A[対象の文章] --> B{操作}
    B -->|review| C[診断だけ<br>逐語引用つきで指摘]
    B -->|refactor| D[該当箇所だけ最小修正]
    B -->|write| E[最初から規範を守って執筆]
    F[核: 日本語AI指紋の禁則] --> B
    G[文書種の追加規則<br>返答・報告など] --> B
    H[声の設定 voice.md<br>あなたの一人称・語尾・禁句] -->|核より優先| B

構成

skills/unai/SKILL.md — 操作（review / refactor / write）と手順
skills/unai/references/core-pass.md — 日本語AI指紋の核（全文書種共通）
skills/unai/references/domains/chat-replies.md — AIの返答・報告向けの追加規則
skills/unai/references/voice-profile.md — 声の設定の書き方
AGENTS.md — 製品の所有境界と文書管理
RELEASE.md — リリースと版固定による復旧の契約

文書種別の追加規則（ブログ記事・製品記事・SNS投稿）は、実測で検証してから順次足します。

ライセンス

MIT

サポートとセキュリティ

使い方や不具合は GitHub Issues へ。脆弱性の報告は公開Issueへ書かず、セキュリティポリシーに従ってください。

Name		Name	Last commit message	Last commit date
.claude-plugin		.claude-plugin
.github		.github
bin		bin
lib		lib
scripts		scripts
skills/unai		skills/unai
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
RELEASE.md		RELEASE.md
SECURITY.md		SECURITY.md
SUPPORT.md		SUPPORT.md
install.ps1		install.ps1
install.sh		install.sh
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Uh oh!

Repository files navigation

unai

30秒でできること

なぜ日本語専用なのか

何を指紋と見なすか（抜粋）

インストール

Claude Code

Codex / Grok / Cursor（Claude Codeでも可）

「実ファイルがあるため上書きしない」と出たとき

工場向けread-only診断の契約

使い方

適用範囲は3段階から選ぶ

声の設定（voice profile）

仕組み

構成

ライセンス

サポートとセキュリティ

About

Releases

Packages

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

unai

30秒でできること

なぜ日本語専用なのか

何を指紋と見なすか（抜粋）

インストール

Claude Code

Codex / Grok / Cursor（Claude Codeでも可）

「実ファイルがあるため上書きしない」と出たとき

工場向けread-only診断の契約

使い方

適用範囲は3段階から選ぶ

声の設定（voice profile）

仕組み

構成

ライセンス

サポートとセキュリティ

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages