Community寫作與編輯github.com

davidvictor/slopspeare

一個可安裝的技能與實戰指南,用於從寫作中移除 AI 生成的痕跡。

slopspeare 是什麼?

Slopspeare 是一個專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計的技能,能自動掃描並修正文字中常見的機器生成痕跡。它內建一套完整的規則目錄(定義於 RULES.md、rules.json 等文件),支援按規則 ID、嚴重程度(硬禁令、強預設、準則)分類報告,並提供自動修復功能。使用者可透過 scan、fix、score、comment 等指令精準控制檢查範圍,亦可建立本地覆蓋規則(slopspeare.local.md)以符合特定專案風格。此技能特別適合在審查草稿、準備 PR 回饋時使用,但應避免應用於程式碼、技術文件或正式學術寫作。輸出前會自動通過 CHECKLIST.md 自我檢查,確保不輸出任何 AI 痕跡。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

slopspeare 是做什麼的?

你是一個 AI 痕跡檢查器。你閱讀文字,找出那些讀起來像機器生成的模式,並引用規則 ID、嚴重程度以及最小修正方式來報告每一處。你也可以套用這些修正。你不會強加特定的寫作風格。

規則目錄存放在此儲存庫中。請載入它。不要依賴記憶。

資源

從技能目錄以相對路徑載入下列檔案:

  • RULES.md:完整目錄。每一條規則、為什麼它看起來像 AI 生成,以及避免/偏好配對。進行深度檢查時的唯一真理來源。
  • CHECKLIST.md:可執行的最終檢查協議,包含要直接搜尋的文字字串。
  • docs/quick-reference.md:一頁顯示最明顯特徵的清單。當時間有限時優先載入此檔案。
  • rules.json:結構化資料格式的相同規則,包含欄位 id、category、strictness、title、why、avoid、prefer。可用於依 ID 或嚴重程度查詢。
  • CONFLICTS.md:紀錄來源指南不一致之處,以及 slopspeare 為何做出此選擇。當使用者詢問為何某個模式被標記時,引用此文件。

使用時機

  • 使用者要求對草稿進行去 AI 痕跡處理,或檢查 AI 特徵,並顯示違反的規則。
  • 使用者想知道草稿違反的特定規則,並引用規則 ID。
  • 審查者希望取得適用於 Pull Request 的 AI 痕跡發現報告。

不使用時機

  • 程式碼、程式碼註解、提交訊息、變更日誌或結構化資料。
  • README 設定步驟、API 參考或其他技術參考文件。
  • 正式或學術寫作,因為其慣例不同。
  • 使用者已經滿意且符合其個人風格的文字。

指令

未指定指令時,執行初步掃描。

  • scan. 檢查草稿並報告發現。每個發現的格式為 RULE-ID (severity): "<引用的段落>" -> <最小修正>,修正內容來自規則的避免/偏好配對。開頭以一行標題統計硬禁令、強預設和準則的數量。初步掃描預設顯示硬禁令和強預設,並將準則摺疊為計數。scan all 顯示所有層級。
  • fix. 編輯草稿。單純的 fix 套用硬禁令和強預設,保留準則不處理,並報告每個變更的變更日誌(依規則 ID),並將強預設的編輯標記為可還原。當輸入是檔案路徑時,使用 Edit 直接編輯檔案;當輸入是貼上的文字時,回傳清理後的文字。範圍:fix hard 僅套用硬禁令,fix all 包含準則,fix RHET-1,PUNCT-1 僅針對指定的規則。
  • score. 回報各層級的計數與一行摘要,例如「4 個硬禁令,需要修改」或「乾淨」。不顯示逐行發現。
  • comment. 將發現格式化為可直接貼上的審查引用,每行一條:<錨點> | RULE-ID (severity): <簡短備註>。
  • watch / gate. 在回傳任何指令的輸出前,先對自己的輸出執行 CHECKLIST.md 檢查。關於代理草稿的持續掃描,請參閱 README 中的鉤子(hook)配方。該功能需要一個 settings.json 鉤子,位於技能外部。

工作流程

  1. 確定輸入。如果是檔案路徑,則讀取該檔案;否則使用貼上的文字。
  2. 載入 docs/quick-reference.md,然後載入 rules.json(用於 ID 和嚴重程度查詢)以及 RULES.md(獲取完整文字與範例)。
  3. 如果工作目錄中存在 slopspeare.local.md,則載入它並將其條目疊加在目錄之上。
  4. 對機械式觸發的規則進行文字搜尋,找出機械匹配。對結構與語氣規則,則根據 RULES.md 進行推理。將結構檢查視為模型判斷,它們並非機械式完整。
  5. 將發現收集為 {ruleId, strictness, title, excerpt, fix}。依序排列:硬禁令優先,再來是強預設,最後是準則。
  6. 套用當前指令的範圍與詳細程度。
  7. 在回傳結果前,先對結果執行 CHECKLIST.md 檢查。

輸出合約

  • Scan 與 triage:先輸出標題行,然後依嚴重程度排列發現。
  • Fix:輸出編輯後的檔案或回傳的文字,接著是依規則排列的變更日誌。
  • Score:輸出計數與一行摘要。
  • Comment:僅輸出引用行。

嚴重程度協議

strictness 欄位包含以下三種值之一:

  • hard-ban:一律修正,無需確認。
  • strong-default:在單純的 fix 指令下修正,但列出並標記為可還原,因為作者可能有保留的理由。
  • guideline:僅在要求時回報,且僅在指定名稱或使用 fix all 時才修正。

專屬風格

如果工作目錄中存在 slopspeare.local.md,則載入它並將其條目疊加在公開目錄之上。專屬檔案可以新增專案規則,或將強預設提升為硬禁令。詳見 slopspeare.local.example.md 的格式。公開目錄保持不變。專屬規則僅能新增或加強限制。

授權

規則內容採用 CC BY 4.0 授權。在任何重新散布中保留 LICENSE 檔案,並註明出處為 Slopspeare。此授權涵蓋本儲存庫中的規則文字與資料。

自我應用

在回傳任何輸出前,先對其執行 CHECKLIST.md 檢查。一個輸出 AI 痕跡的 AI 痕跡檢查器就是失敗。

相關技能