mcpField
D
de-slopify

de-slopify

github.com/oakossドキュメント20139 回インストール11 週間前に更新
リポジトリ

de-slopify について

de-slopifyは、AIらしい特徴がある文章、ドキュメント、コードを見直すための方法論です。技術的な意味を保ちながら、文体のパターンや過剰設計を見つけたい執筆者やレビュアー向けです。

主な機能

  1. 01AI文章パターンのチェックリスト
  2. 02文章とドキュメントの編集指針
  3. 03AI生成コードのコードスメル確認
  4. 04文体調整と編集ワークフロー
  5. 05レビュー作業の委任ガイド

活用シーン

  1. 01公開前のREADMEレビュー
  2. 02AI支援で書いた文章の編集
  3. 03生成コードの不要な抽象化の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oakoss/agent-skills --skill de-slopify

インストール後、Claude Code で/de-slopifyを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
before-and-after.md
code-slop.md
prose-patterns.md
review-workflow.md
slop-vocabulary.md

詳細

De-Slopify

概要

De-slopify は、ドキュメント、文章、コードから、AI 生成コンテンツにありがちな特徴を取り除くための方法論です。LLM は、特徴的な語彙、句読点の使い方、構造的パターンを伴う、統計的に規則的な出力を生成するため、文章やコードが不自然に感じられることがあります。人間が書いた文章よりも、LLM の出力で 1,000 倍以上頻繁に現れるパターンもあります。

使用する場面： README を公開する前、AI を使った執筆作業の後、ドキュメントのレビュー中、過剰な設計になっていないか AI 生成コードを確認するとき、LLM が手を加えた文章やコードをコミットする前。

使用しない場面： 正しさがスタイルより重要な、コードのロジックやアルゴリズム。語調より正確さが重要な技術仕様。すでに人間が書いていて、自然に読めるコンテンツ。

クイックリファレンス

カテゴリーパターン修正方法
句読点emダッシュの多用セミコロン、コンマ、コロンを使うか、2つの文に分ける
フレーズ「その理由は」／「重要な理由は」前置きを使わず、理由を直接説明する
フレーズ「X ではなく Y」「これは Y です」とするか、違いを言い換える
フレーズ「詳しく見ていきましょう」／「始めましょう」削除する。内容から始める
フレーズ「注目すべきなのは」／「覚えておいてください」ぼかし表現を削除し、事実を述べる
フレーズ「本質的には」／「要するに」／「根本的には」削除し、内容を直接述べる
語彙「深く掘り下げる」「タペストリー」「状況」「微妙な」平易で具体的な表現に置き換える
語彙「革命を起こす」「最先端」「画期的」具体的な主張に置き換えるか、削除する
構成文の長さが全体を通して均一短い文（5語）と長い文（20語以上）を織り交ぜる
構成3項目ちょうどで均整の取れたリストリストの長さに変化をつける。人間は2項目、4項目、または奇数個を使う
構成具体性のない一般的な主張名前、日付、数字、または一人称の詳細を加える
迎合「良い質問ですね！」／「もちろんです！」削除し、質問に直接答える
メタ表現「詳しく説明します……」／「説明させてください」前置きを削除し、すぐに説明する
構成1文で済む内容の番号付きリスト文で表現し、リストは本当に並列な項目に使う
締めくくり「結論として」／「要約すると」削除するか、具体的な要点に置き換える
コード簡単な関数への過剰なコメントコードの内容を言い換えているだけのコメントを削除する
コード不要な抽象化やデザインパターン最もシンプルに動作する解決策に簡素化する
コード冗長すぎる、または説明的すぎる変数名ドメインに合った簡潔な名前を使う
コードあらゆる処理に対する不要な防御的エラー処理失敗が現実的に起こり得る箇所だけでエラーを処理する

よくある間違い

間違い正しい方法
すべての emdash を機械的に置き換える文脈を確認してください。emdash が適切な場合もあります
スタイルを整えるためにコードブロックを編集する散文に集中し、コード例や技術的な構文には手を加えないでください
くだけた印象にするために構造をすべて取り除く見出し、表、リストはそのまま残し、散文だけを書き換えてください
修正しすぎて断片的な文章にする編集後に声に出して読み、流れが損なわれた文はつなぎ直してください
目指す文体を定めずに修正を適用する編集を始める前に、ペルソナ、トーン、対象読者を設定してください
読まずに正規表現で置換する行ごとの手動レビューが必要です。修正内容は文脈によって決まります
AI 生成コードのコード臭を無視するAI 生成コードを確認し、過剰な設計、冗長な名前、不要な抽象化がないか調べてください
LLM にありがちな単語を無条件にすべて削除する指摘された単語の中にも、文脈によってはごく自然なものがあります。判断して使ってください

委任

  • リポジトリをスキャンし、AI らしさを取り除く必要があるドキュメントファイルを探す：Explore エージェントを使用してください
  • ドキュメントサイト全体を書き換えて AI らしさを取り除く：Task エージェントを使用してください
  • ドキュメントの文体ガイドと編集ワークフローを計画する：Plan エージェントを使用してください
  • AI 生成コードにコード臭のパターンがないかレビューする：code-reviewer エージェントを使用してください

アーキテクチャ、セキュリティ、テスト、パフォーマンスなど、12 の観点から体系的な品質監査を行うには、quality-auditor スキルを使用してください。

参考資料

コメント

Markdown 対応