unpolish-ai-writing について
Unpolish は、文章からAIらしい表現を取り除いたり、依頼に応じて少数のタイプミスを加えたりするテキスト編集スキルです。二つの処理を分け、ファイルの直接編集条件や監査、出力手順も定めています。
主な機能
- 01AIらしい定型表現の除去
- 02清書後の二次監査
- 03依頼に応じた少数のタイプミス追加
- 04誤り追加のみと清書の手順分離
- 05許可がある場合のみファイルを直接編集
活用シーン
- 01貼り付けた文章から定型句や機械的な表現を除去
- 02清書した草稿に少数のタイプミスを追加
- 03清書せず元の文章に誤りだけを追加
- 04明示的な許可を得て文章ファイルを編集
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wilu222/ unpolish-ai-writing --skill unpolish-ai-writingインストール後、Claude Code で/unpolish-ai-writingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSENOTES.mdREADME.md.claude-plugin/plugin.jsonmarketplace.jsonreferences/imperfections.md詳細
Unpolish
2 つの関数があります。deslop は AI らしい文章の特徴を取り除き、imperfections はハッシュを使ってまばらにタイピングミスを加えます。デフォルトでは deslop のみを実行します。ユーザーから指示があった場合に imperfections を追加します。imperfections only は deslop を完全にスキップし、与えられたテキストにそのまま変更を加えます。
呼び出し方法
リクエストから、どの処理を実行するか判断します。
| ユーザーの指示 | 実行する処理 |
|---|---|
unpolish / deslop / 追加の指示なし | 除去+2 回目の監査。imperfections はスキップします。 |
unpolish and add imperfections / deslop + imperfections | 除去、監査の後、除去後の原稿にハッシュを使って変更を加えます。 |
imperfections only / just add imperfections / don't strip / skip deslop | 与えられたテキストにハッシュを使って変更を加えます。除去も 2 回目の監査も行いません。 |
reroll / vary it / try other imperfections → imperfections の処理で内部ソルトを新たに生成します。除去を再度有効にはしません。
| ユーザーが提供するもの | 対応 |
|---|---|
| 貼り付けられたテキスト | 結果と、簡潔な監査メモ/変更メモを返します(「提供」セクションを参照)。 |
| 文章ファイル+明示的なファイル内編集の依頼(「このファイルを編集/修正して」) | ファイルを直接編集して検証し、要約します。ソースコード、設定ファイル、データファイルの場合は拒否します。 |
| 編集の許可なく名前だけ指定されたファイル | 読み取り/監査を行い、修正案を返します。ファイルは変更しません。 |
処理手順
Unpolish progress:
- [ ] 1. Strip pass (skip if imperfections-only)
- [ ] 2. Second-pass audit (skip if imperfections-only)
- [ ] 3. Imperfections (skip unless asked)
- [ ] 4. Deliver
flowchart TD
input[Draft text] --> route{Which passes?}
route -->|deslop or both| strip[Strip AI writing signs]
strip --> audit[Second-pass audit]
audit --> bothCheck{Imperfections asked?}
bothCheck -->|yes| imperfBoth[Imperfections on stripped draft]
bothCheck -->|no| outDeslop[Deslopped draft]
route -->|imperfections only| imperfOnly[Imperfections on text as given]
1. 除去処理
ユーザーが imperfections only を指示した場合はスキップします。
以下の 3 つのカテゴリを確認します。単発の例より、まとまった複数の例を重視します。形式ばった文が 1 つあるだけでは書き直す理由になりません。特徴がいくつも重なっている場合に修正します。
必ず修正すべき項目は修正します。判断に迷う項目は、いくつも重なっている場合にのみ修正します。
そのままにするもの: コード、表、URL、引用、タイトル、固有名詞、数字、出典を明示した発言、すでに人が書いたように聞こえる箇所。
絶対に加えないもの: 作り話の個人的なエピソード、無理に入れた「lol」や絵文字の羅列、短い断片文の連続、「不完全さ」としての類義語の羅列、コンマで文をつなぐ誤り、imperfections の手順以外での誤字や文法ミス。意図的なミスは、imperfections の処理でのみ加えます。
カテゴリ A — アシスタントの残り香(必ず修正)
- チャットボットらしい書き出し/結び(「Certainly!」「Happy to help!」「Hope this helps!」)— 書き出しと、助言に入る前の前置きをすべて削除します。「私ならこうします」などに置き換えてはいけません。
- 学習データの期限や「AI として」といった免責事項
- 思考過程の漏出(「はっきりさせておくべきなのは……」といった表現や、執筆中の作業を語る表現)。考えながらの自己訂正(「待って、それは違う――」)は人間らしいため、そのままにします。
- おべっか、過剰な称賛、要約に称賛を添えた書き出し(回答の前に、ユーザーの状況を称賛を交えて丸ごと言い直すもの)
- チャット UI から貼り付けられた曲がった引用符やアポストロフィは、書き手自身の文章では
"/'に置き換えます。引用文、コードブロック、各言語で正しい句読点の箇所はそのままにします。 - 「A ではなく、B だ」という転換や、否定表現の連続(「A ではない。B でもない。C だけだ。」)— 例外なく書き直します。1 つだけでも修正します。
バケット B — 中身がないのに深遠に見せる表現(繰り返される場合は必ず修正。それ以外は判断)
- 確立された概念であるかのように使われる、作り出された概念ラベル(「Xのパラドックス/罠/クリープ」など)
- 重要性の誇張(APIの調整を文明規模の出来事のように描く)
- 曖昧な「専門家によると」や、名前の挙がらない権威者
- 根拠の薄い主張を取り繕う魔法の副詞(以下の「常に置き換える表現」を参照)
- 並列の三項ルール:文法上の骨格が同じ項目が3つ並ぶ場合(短い節が3つ、動詞句が3つ、「It's X」の形が3つなど)は、3つとも事実であっても必ず修正します。節を主語のない断片に切り分けるのではなく、従属させるか、まとめてください。裸の名詞の列挙(買い物リスト、材料など)は、その文が三拍子のスローガンにもなっている場合を除き、そのままにします。中身のない重要性を添える語句(
that matters、that isn't pretending to be X)は列挙ではありません。語尾を削るか、具体的な仕様を示してください - コピュラの回避(「serves as」「stands as」など。「is」でよい場合)
- 動詞のない名詞断片:機能を説明する節の代わりに名詞句や形容詞句を置き、主語もコピュラも欠いているもの(
Porcelain-enameled kettle.、Less busywork. More impact.など)。ひと続きの箇所につき一度はIt's/It hasを補ってください。正当な列挙も、文中の別の箇所に主語と動詞が必要です - 文章全体で段落や文の長さが均一になっていること。カジュアルな文体なのに、文法や並列構造まで整いすぎて台本のように読める場合も含みます。ここで誤字を意図的に入れてはいけません。誤字は不自然さを加える工程でのみ扱います
バケット C — 機械的なリズム
- ダッシュの多用:必ず修正
- 同義語の使い回し:同じ語の反復を避けるために同義語を次々と使うこと(「developers… engineers… practitioners… builders」など)。人は最も明確な語を繰り返します。同じ名詞や動詞が3回出てきても、それが適切な語ならすべてそのままにします
- 歯切れのよい一行断片や、作為的なパンチラインの多用。同じ形の拍子が3つ以上続く場合(独立した短文、短い段落、またはわざと息継ぎを演出する並列節など)
- キャプション/日記調の主語省略:暗黙の一人称主語を省いた、説明的な振り返りの節(「Made…」「Fixed…」「Went…」「shut the valves, swapped…」など)。書き出しの文は必ず修正します。主語の省略が2つ以上ある場合はすべて修正します。三拍子の一部でもある省略は必ず修正します。三拍子に含まれない文中の単独の省略は、要判断です。文や節のまとまりごとに主語を一度補い、歯切れをよくするために再び省略しないでください。例外:タイトル、材料/手順のブロック、変更履歴、レシピの命令形の手順
- まとめを予告する表現や、結びの決まり文句:「In conclusion…」「At the end of the day…」、That’sを重ねる表現(「That’s it. That’s the soup.」)、カテゴリーを示すだけの結び(「It’s dinner.」「That’s Thursday.」)、締めくくりの宣言(「That’s the update/post/method.」など)。結びの飾りは削り、最後の具体的な事実で終えてください。別の短い決まり文句に置き換えてはいけません
置き換える語句
3段階に分かれています。活用形も対象です(quietlyは重要性を飾るquietの意味で、leveragingはleverageとして扱います)。robust/ecosystemは、比喩的な水増しではなく実際の技術用語であれば残してください。
優先順位: 副詞のremarkablyは、重要性を飾る表現として常に置き換えます。形容詞のremarkableは、表現が過剰な文章で同じ中身のない重要性を示す役割を果たしている場合を除き、「密度のみ」の対象です。
常に置き換える
| 置き換える表現 | 置き換え後 |
|---|---|
| quietly(重要性を誇張する表現) | 削除するか、実際に何が変わったかを明記する |
| deeply + integrated / committed / rooted / intertwined | 具体的なつながりを明記する。「cares deeply」は文字どおりの意味で使う場合に限り残す |
| fundamentally(中身のない深みを演出する表現) | 削除するか、何が壊れたか、何が変わったかを明記する |
| remarkably / arguably(重要性を誇張する表現) | 削除するか、根拠を示す |
| genuinely / genuine(強調表現としての用法) | 削除する。事実だけを述べる |
| delve / dive deep / deep dive | look at / dig into |
| landscape(比喩) | field / market / scene、または具体的な名詞 |
| tapestry | 実際の組み合わせを明記する |
| embark | start |
| leverage(動詞) | use / build on |
| utilize | use |
| robust(宣伝文句、埋め草) | solid / reliable / holds up |
| seamless / seamlessly | smooth / without extra steps |
| nestled | in / near / sits in |
| lands / landed / land on(比喩:公開する、決定する、「うまくいった」) | came out / arrived / dropped、pick / go with / end up with、worked / stuck。中身のない「glad it landed」は削除する。航空機、鳥、地面を指す文字どおりの用法は残す |
| vibrant(宣伝文句) | busy / lively / 削除する |
| thriving(宣伝文句) | growing / busy / 数字を示す |
| showcase / showcasing | show / 節を削除する |
| testament to | shows / proves |
| game-changer / game-changing | 何が変わったかを明記する |
| groundbreaking / revolutionary | new / first time we’ve… |
| cutting-edge | latest / newest |
| in order to | to |
| serves as / stands as | is |
| moreover / furthermore / additionally | also / and / 削除する |
| at its core | 削除して、核心となる事柄を明記する |
| it’s important to note that | 削除して、注記の内容から書き始める |
| amidst | amid / in |
| load-bearing / load bearing | essential / critical、または、それを取り除くと何が壊れるかを明記する |
| realm | area / field / domain |
| meticulous / meticulously | careful / detailed |
| intricate / intricacies | complex / detailed |
| ever-evolving | changing / growing |
| impactful | effective / significant |
| paradigm | model / approach |
| comprehensive | full / covers X and Y |
| pivotal | big / deciding |
| underscore | show / highlight |
| unpack | explain / walk through |
| holistic | whole / across |
| actionable | practical / concrete |
| synergy | 誰が誰と協力するのかを明記する |
集中して使われている場合 — 1つの段落に2つ以上ある場合は要確認
| 置き換える表現 | 置き換え後 |
|---|---|
| harness | use / take advantage of |
| foster | encourage / support / build |
| streamline | simplify / cut steps |
| empower | let / enable |
| crucial / critical(常用されている場合) | important / the blocker is… |
| ecosystem(比喩) | system / community / network |
| myriad / plethora | many / a number |
| facilitate | help / run |
| enhance | improve / add |
| navigate(比喩) | handle / work through |
| resonate | matter to / click with / 削除する |
使用頻度 — 文中の約3%以上を占める場合、または2文おきに続く場合のみ置き換える
| 置き換える表現 | 置き換え後 |
|---|---|
| significant | big / real / 中身がなければ削除する |
| innovative | new / different / 違いを明記する |
| compelling | strong / convincing / 中身がなければ削除する |
remarkable(形容詞。remarkablyについては「常に置き換える」を参照) | surprising / unusual / 削除する |
| noteworthy | 事実を明記する |
| interesting(中身がない場合) | 理由を明記するか、削除する |
2. 2回目の見直し
ユーザーが欠点のみを求めている場合は省略してください。
表現を削った後、次の2点を簡潔に声に出して確認してください。
- まだAI生成文のように読める箇所はありませんか?(滑らかさ、話題の転換、アシスタントらしい口調、見せかけの深み)
- 事実を作り足したり、くだけた口調を演出したりしていませんか?(新しい逸話、無理な俗語、誤字の乱用)
問題があれば修正してください。文章全体がAI生成文のような構成なら、部分的な修正ではなく、全体を書き直してください。
3. 不自然な箇所の処理
ユーザーが不自然な箇所の処理を求めていない場合はスキップしてください。 求められた場合は、references/imperfections.md を読み、指示に従ってください:λ ≈ max(0.05, word_count / 600)、SHA-256 の手順、タイプごとの範囲、スペルミス/誤語の候補、QWERTY。該当するタイプがない場合、またはポアソン分布で P(k=0) となる場合は、問題を加えずにスキップします。imperfection: none または imperfection: <type> @ … と報告します(スペルミス/誤語の場合は wrong_word)。
ユーザーが deslop をスキップし、不自然な箇所の処理のみを求めた場合、手順で使う text は、strip rewrite ではなく元の貼り付け内容/ファイルです。deslop と不自然な箇所の処理の後に、strip 済みのドラフトをハッシュ化します。
4. 提出
Deslop(不自然な箇所の処理の有無を問わず)— 3 つのセクション:
- Audit — 見つかった箇所を示し(短い範囲を引用)、必須の修正と判断に委ねられる修正を区別します
- Rewrite — 整えた全文(求められた場合は不自然な箇所の処理も反映)
- Changes — 変更内容と理由を簡潔に箇条書きで示します
不自然な箇所の処理のみ — 2 つのセクション:
- Rewrite — ハッシュ抽選後のテキスト(Audit は記載しません)
- Changes —
imperfection:の行のみ
出力時の注意
- セクション間の文章は簡潔にし、Rewrite に注力してください。
- 問題箇所は、曖昧に言い換えず引用してください。