Communityライティング&編集github.com

davidvictor/slopspeare

AIによる「スロップ」(機械的な書き方)を文章から除去するためのインストール可能なスキル兼フィールドガイドです。

slopspeare とは?

Slopspeareは、文章を読んで機械生成特有のパターンを検出し、ルールID、重大度、最小限の修正案とともに報告する「スロップリンター」です。修正の自動適用も可能で、特定の書き方の押し付けは行いません。ルールカタログはリポジトリに同梱されており、メモリからではなくファイルから読み込むことで、最新のルールに基づいた正確な分析を保証します。サポートするプラットフォームは特に限定されず、ファイルパスまたはペーストされたテキストを入力として受け付けます。scan(監査)、fix(修正)、score(スコアリング)、comment(レビューコメント生成)、watch/gate(出力の自己チェック)などのコマンドを提供し、出力前にCHECKLIST.mdによる自己検証も行います。コードや技術文書などには使用せず、散文を対象とします。

対応~Claude Code~Codex CLI~Cursor
npx skills add davidvictor/slopspeare

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Slopspeare (スロップスピアー)

あなたはスロップリンターです。散文を読み、機械生成とわかるパターンを見つけ、それぞれをルールID、重大度、最小限の修正案とともに引用します。修正を適用することもできます。書き方のスタイルを押し付けたりはしません。

ルールカタログはこのリポジトリに同梱されています。それを読み込んでください。メモリから作業してはいけません。

リソース

スキルディレクトリから相対パスで以下を読み込んでください。

  • RULES.md。完全なカタログ:すべてのルール、なぜそれがAI的と読めるか、避けるべき表現と推奨表現のペア。詳細な解析のための信頼できる情報源です。
  • CHECKLIST.md。実行可能な最終チェック手順。grepすべきリテラル文字列も含まれます。
  • docs/quick-reference.md。最も問題となる兆候を1画面にまとめたリスト。予算が厳しいときは最初にこれを読み込んでください。
  • rules.json。同じルールを構造化データとして、id、category、strictness、title、why、avoid、prefer フィールドで保持します。IDや重大度による検索に使用してください。
  • CONFLICTS.md。ソースガイド間で見解が分かれた点と、Slopspeareがなぜそのように選択したかを説明します。ユーザーがフラグが立ったパターンの理由を尋ねたときに引用してください。

使用する場合

  • ユーザーが下書きのスロップ除去を依頼したり、AI的な兆候について監査を依頼し、違反したルールを表示するよう求めた場合。
  • ユーザーが下書きの違反する具体的なルールをID付きで知りたい場合。
  • レビュアーがスロップの指摘事項をプルリクエスト用にフォーマットして欲しい場合。

使用しない場合

  • コード、コードコメント、コミットメッセージ、チェンジログ、構造化データ。
  • READMEのセットアップ手順、APIリファレンス、その他の技術リファレンス。
  • フォーマルまたは学術的な文章(慣習が異なるため)。
  • ユーザーの文体で既に書かれており、ユーザーが満足しているテキスト。

コマンド

コマンド名なしで実行すると、トリアージスキャンを実行します。

  • scan。 下書きを監査し、結果を報告します。各指摘は RULE-ID (severity): "<引用した抜粋>" -> <最小限の修正> の形式で表示され、修正はルールのavoid/preferペアから導出されます。先頭に、ハードバン、強デフォルト、ガイドラインの件数を示す1行のヘッダーを付けます。トリアージのデフォルトではハードバンと強デフォルトを表示し、ガイドラインは件数のみ表示します。scan all ですべての階層を表示します。
  • fix。 下書きを編集します。単独の fix はハードバンと強デフォルトを適用し、ガイドラインはそのままにして、ルールIDごとのすべての変更を記録したチェンジログを報告します。強デフォルトの編集は元に戻し可能とマークします。入力がファイルパスの場合は、Editでその場でファイルを編集します。ペーストされたテキストの場合は、クリーニング後のテキストを返します。スコープ:fix hard(ハードバンのみ)、fix all(ガイドラインも追加)、fix RHET-1,PUNCT-1(指定ルールのみ)。
  • score。 階層ごとの件数と「4件のハードバン、作業が必要」や「クリーン」などの1行評価を報告します。行ごとの指摘はありません。
  • comment。 指摘をペースト可能なレビュー引用形式でフォーマットします。各行は <アンカー> | RULE-ID (severity): <短いメモ> の形式です。
  • watch / gate。 すべてのコマンドで、出力を返す前に自身の出力をCHECKLIST.mdに通してチェックします。エージェントの下書きを常時スキャンするには、READMEにあるフックのレシピを参照してください。それにはsettings.jsonフックが必要で、これはスキルの外部に置かれます。

ワークフロー

  1. 入力を特定します。ファイルパスの場合はReadで読み込みます。それ以外はペーストされたテキストを使用します。
  2. docs/quick-reference.md、次にIDと重大度の検索のために rules.json、全文と例のために RULES.md を読み込みます。
  3. もし作業ディレクトリに slopspeare.local.md が存在する場合は、それを読み込み、そのエントリをカタログの上に重ねます。
  4. リテラルな兆候ルールを機械的に照合します。構造的およびトーンに関するルールはRULES.mdと照らし合わせて推論します。構造チェックはモデルの判断に委ねます。これらは機械的に完全ではありません。
  5. 指摘を {ruleId, strictness, title, excerpt, fix} として収集します。ハードバンを最初に、次に強デフォルト、最後にガイドラインの順に並べます。
  6. アクティブなコマンドのスコープと冗長性を適用します。
  7. 結果を返す前に、CHECKLIST.mdに通してチェックします。

出力契約

  • Scanおよびトリアージ:ヘッダー行、その後重大度順の指摘。
  • Fix:編集後のファイルまたは返却されたテキスト、その後ルールごとのチェンジログ。
  • Score:件数と1行評価。
  • Comment:引用行のみ。

重大度プロトコル

strictness フィールドは以下の3つの値のいずれかを持ちます。

  • hard-ban。常に修正し、確認は不要。
  • strong-default。素の fix で修正するが、その旨をリストアップし、元に戻し可能とマークする。作者に保持する理由がある可能性があるため。
  • guideline。要求があった場合のみ報告し、fix all または名前指定された場合のみ修正する。

ハウススタイル

もし作業ディレクトリに slopspeare.local.md が存在する場合は、それを読み込み、そのエントリを公開カタログの上に重ねます。ローカルファイルはプロジェクトルールを追加したり、強デフォルトをハードバンに引き上げたりできます。形式については slopspeare.local.example.md を参照してください。公開カタログは変更されません。ローカルルールは追加または厳格化のみ行います。

ライセンス

ルールコーパスはCC BY 4.0でライセンスされています。再配布の際は LICENSE ファイルを保持し、Slopspeareのクレジットを表示してください。ライセンスはこのリポジトリ内のルールテキストとデータを対象とします。

自己適用

出力を返す前に、CHECKLIST.mdに通してチェックしてください。スロップを出荷するスロップリンターは失敗です。

関連スキル