@moon791017/neo-skills 1.1.0 → 1.1.2

package/README.md

@@ -86,6 +86,10 @@
 
 * **AI 助手開發治理 (`skills/neo-agent-harness`)**：檢查專案規則、測試、CI、審查流程與安全防護是否足夠清楚，協助 AI 助手更穩定、更安全地參與開發。
 
+### 13. AI Tells / Slop 贅詞消除專家
+
+* **文字去 AI 腔調 (`skills/neo-stop-slop`)**：消除中英文 AI 腔、贅詞與公式化囉唆句式，還原為乾淨、生動且簡煉的自然語言，並包含工程師註解、Git Commit 及 PR 說明的特化優化。
+
 ## 📂 系統架構
 
 本專案主要由標準專家技能模組組成的知識庫所構成：
@@ -96,26 +100,51 @@
 
 ## 📦 安裝與使用
 
-Neo Skills 已全面升級並採用 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。
+Neo Skills 已全面升級並支援專屬的極簡安裝器，同時相容於 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。
+
+根據您的使用場景，可以選擇以下兩種最適合您的安裝方式：
+
+---
+
+### 一、一鍵同步全域技能（Antigravity CLI 專用，推薦）
 
-透過標準的 **Skills CLI**，您不需要手動下載、複製或在 `CLAUDE.md` 等檔案中手動附加長篇大論的系統提示詞。現代的 AI Coding Agents（如 Claude Code, Cursor, Copilot 等）已原生支持從 `.agents/skills/` 自動發現與加載這些高度專業的技能。
+如果您使用的是 **Antigravity CLI**，建議使用專門設計的 `neo-skills` 安裝工具（舊稱 `install-skills`）。這是一個極簡化的工具，會一鍵將本專案所有的專家技能，複製到您的全域路徑 `~/.gemini/antigravity-cli/skills` 中，同時自動過濾無關檔案（如 `.git`、`node_modules`、`.DS_Store` 等）。
 
-> [!NOTE]
-> 技能下載管理工具底層使用由 Vercel Labs 開源的全球 package manager `skills` (即 `@vercel/skills`)。這使得技能的安裝與管理如同 npm 安裝套件般優雅、快速。
+#### 透過 npx 直接執行：
+```bash
+npx -y @moon791017/neo-skills@latest
+```
+
+#### 本地開發手動安裝：
+如果您已複製本專案至本地，也可以直接在專案根目錄下執行：
+```bash
+node bin/install-skills.js
+```
 
 ---
 
-### 一、一鍵安裝所有技能
+### 二、使用標準 Skills CLI 安裝（通用於專案或其他 AI Agent）
 
-如果您希望將 Neo Skills 專案內建的所有專家技能一次性安裝至您的當前專案中，只需在專案根目錄下執行：
+針對其他支援 [agentskills.io](https://agentskills.io) 標準規範的 AI 代理（如 Claude Code, Cursor, Copilot 等），您可以使用標準的 `skills` 包管理器。預設會安裝至當前專案，**若您希望將技能安裝至全域路徑，只需在指令後方加上 `-g` 參數**。
 
+#### 1. 專案一鍵安裝所有技能（免互動勾選）：
 ```bash
-npx skills add Benknightdark/neo-skills
+npx skills add Benknightdark/neo-skills --all
 ```
 
+> [!TIP]
+> * **全域一鍵安裝**：若要將所有技能安裝至標準全域路徑下，只需加上 `-g`：`npx skills add Benknightdark/neo-skills --all -g`。
+> * **命令行指定**：若只需安裝特定 Skill，可以使用 `--skill <名稱>`（例如 `npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue`）。
+
+#### 💡 終端機互動選單操作小秘訣：
+如果您執行了不帶 `--all` 的預設互動選單命令 `npx skills add Benknightdark/neo-skills`：
+1. **一鍵全選 (Select All)**：在選單畫面中直接按下鍵盤上的 **`a`** 鍵，即可立刻自動勾選所有的技能！
+2. **反向選取 (Invert Selection)**：按下鍵盤上的 **`i`** 鍵，反向切換目前的所有勾選狀態。
+3. **確認送出**：全選後按下 `Enter` 鍵即可一次完成安裝。
+
 ---
 
-### 二、按需安裝特定技能
+### 三、按需安裝特定技能
 
 如果您只需要其中某幾項特定領域的專家技能，您可以使用 `--skill` 參數指定安裝：
 
@@ -142,21 +171,7 @@ npx skills add Benknightdark/neo-skills
 | **19. 程式碼解釋助手** | `npx skills add Benknightdark/neo-skills --skill neo-explain` |
 | **20. 需求分析與釐清助手** | `npx skills add Benknightdark/neo-skills --skill neo-clarification` |
 | **21. AI 開發流程治理專家** | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` |
-
----
-
-### 三、主流 AI Agent 對齊說明
-
-在安裝技能後，主流的 AI 代理會遵循以下載入機制，無須任何額外手動配置：
-
-> [!TIP]
-> **全域安裝選項**：若您希望將技能安裝至全域路徑以供所有專案使用，可以在上述指令後面加上 `-g` 參數（例如 `npx skills add -g Benknightdark/neo-skills`）。
-
-| AI Agent | 專案載入目錄 (Project-level) | 全域載入目錄 (Global-level) | 系統提示載入方式 |
-| :--- | :--- | :--- | :--- |
-| **Antigravity (AGY)** | `<project>/.agents/skills/` | `~/.gemini/skills/` | 自動掃描並動態感知載入（Perceive 階段） |
-| **Claude Code** | `<project>/.agents/skills/` | `~/.claude/skills/` | 原生載入並透過 trigger-phrases 自動觸發 |
-| **Copilot CLI / Cursor** | `<project>/.agents/skills/` | `~/.copilot/skills/` | 自動偵測專案下的 `.agents/` 設定檔案 |
+| **22. AI Tells/Slop 消除專家** | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` |
 
 ---
 
@@ -228,6 +243,7 @@ npx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --in
 | **TS 型別設計與 CJS/ESM 互通** | `neo-typescript` | `npx skills add Benknightdark/neo-skills --skill neo-typescript` | `解決 tsconfig 還有 ESM/CJS 互通性的問題` |
 | **複雜/模糊需求釐清與規格化** | `neo-clarification` | `npx skills add Benknightdark/neo-skills --skill neo-clarification` | `我想做一個電商網站` |
 | **AI 助手開發治理與流程健檢** | `neo-agent-harness` | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` | `幫我檢查這個專案怎麼讓 AI 助手開發得更穩、更安全` |
+| **清除文案/註解/Commit 中的 AI 腔** | `neo-stop-slop` | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` | `消除這段話裡的 AI 腔贅詞，使其極簡直接` |
 
 ## 🛠 開發與測試指南
 

package/bin/install-skills.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * Neo Skills — 全域技能安裝程式
+ *
+ * 用法：
+ *   install-skills        安裝專案的技能至全域 Antigravity CLI 技能目錄 (~/.gemini/skills)
+ */
+import { cp, mkdir, access } from 'node:fs/promises';
+import { join, resolve, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+import { setupGlobalErrorHandlers } from './_cli-utils.js';
+
+setupGlobalErrorHandlers();
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, '..');
+const sourceDir = join(packageRoot, 'skills');
+
+async function main() {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║   🧠 Neo Skills — 全域技能安裝程式       ║');
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  try {
+    await access(sourceDir);
+  } catch {
+    console.error(`❌ 錯誤: 找不到來源技能目錄 ${sourceDir}`);
+    process.exit(1);
+  }
+
+  // 決定安裝目標路徑 (支援透過 TEST_HOME_DIR 覆寫以供測試)
+  const home = process.env.TEST_HOME_DIR || homedir();
+  const targetDir = join(home, '.gemini/antigravity-cli/skills');
+
+  console.log(`🚀 開始同步 Neo Skills 至全域 Antigravity CLI...`);
+  console.log(`📁 來源路徑: ${sourceDir}`);
+  console.log(`🎯 目標路徑: ${targetDir}`);
+  console.log('');
+
+  try {
+    await mkdir(targetDir, { recursive: true });
+
+    let copyCount = 0;
+    await cp(sourceDir, targetDir, {
+      recursive: true,
+      force: true,
+      filter: (src) => {
+        // 解析相對於來源目錄的相對路徑
+        const relativePath = src.replace(sourceDir, '');
+        
+        // 忽略無關的隱藏檔案或特定資料夾
+        const isIgnored = 
+          relativePath.includes('node_modules') || 
+          relativePath.includes('.git') ||
+          relativePath.includes('dist') ||
+          relativePath.includes('.antigravitycli') ||
+          relativePath.includes('.agents') ||
+          relativePath.includes('.DS_Store');
+        
+        if (!isIgnored) {
+          copyCount++;
+          return true;
+        }
+        return false;
+      }
+    });
+
+    if (copyCount === 0) {
+      console.warn('⚠️ 警告: 沒有任何技能檔案被複製。');
+    } else {
+      console.log('══════════════════════════════════════════');
+      console.log(`✅ 安裝成功！已同步 ${copyCount} 個項目到全域。`);
+      console.log('💡 提示: Neo Skills 已成功安裝。請確保您的 Antigravity CLI 已正常啟用技能！');
+    }
+  } catch (error) {
+    console.error(`❌ 安裝失敗:`, error.message || error);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "type": "module",
   "description": "Neo Skills: A Universal Expert Agent Extension",
   "homepage": "https://neo-blog-iota.vercel.app/",
@@ -13,6 +13,8 @@
     "ai agent skills"
   ],
   "bin": {
+    "neo-skills": "./bin/install-skills.js",
+    "install-skills": "./bin/install-skills.js",
     "install-system-instructions": "./bin/install-system-instructions.js"
   },
   "files": [

package/skills/neo-stop-slop/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: neo-stop-slop
+description: >
+  Remove AI writing patterns, tells, and slop from prose, technical drafts, code comments,
+  git commit messages, or pull request descriptions. Supports both Traditional Chinese and English.
+  Use this skill when the user wants to polish, edit, rewrite, or review drafts to make them sound
+  more natural, concise, and direct, or when they ask to eliminate AI tells/slop, even if they don't
+  explicitly say "stop-slop".
+license: MIT
+compatibility: Requires Node.js (ESM) to run the analyze-slop.js script.
+metadata:
+  author: Ben Knight Dark
+  version: "1.0.0"
+  patterns: reviewer, generator
+---
+
+# Neo Stop Slop
+
+`neo-stop-slop` 是一個專門設計用來消除中英文 AI 腔調（AI Tells）、贅詞及公式化囉唆結構的雙核技能。它能讓 AI 生成的文案、技術草稿、程式碼註解、Git Commit 及 PR 說明，轉換為極簡、乾淨且生動的自然語言。
+
+本技能結合了 **Reviewer (文字診斷審查)** 與 **Generator (極簡重寫生成)** 兩大核心工作流。
+
+---
+
+## Gotchas
+
+*   **過度精簡風險**：在進行「Rewrite (重寫)」時，務必確保**沒有遺漏關鍵的技術細節或事實資訊**。去 AI 腔是指「清除贅詞與修飾架構」，而不是刪減實質內容。
+*   **代碼語法與註解標記**：修剪「代碼註解」時，切勿破壞 XML 文件結構（如 C# 的 `<summary>`、`<param>`）或 JSDoc/TSDoc 的結構標記。
+*   **檢測腳本執行**：使用 `analyze-slop.js` 時，一律採用**非互動模式**（傳入 `--file` 或 `--input`，配合 `--format json` 或不帶選項），避免任何 TTY 卡死。
+
+---
+
+## Workflow Checklist
+
+Progress:
+- [ ] **Step 1 — Perceive (感知環境)**：辨識輸入文字的語言（繁中/英文）與場景（文案、註解、Git Commit 或 PR 說明），確認使用者需要 `Review`（診斷）還是 `Rewrite`（重寫）。
+- [ ] **Step 2 — Reason (制定策略)**：根據語言與場景，加載相對應的參考手冊（`references/` 資源檔）。
+- [ ] **Step 3 — Act: Review (執行診斷，若適用)**：執行內建的 `scripts/analyze-slop.js` 統計贅詞並計算 Slop 密度分數。
+- [ ] **Step 4 — Act: Rewrite (執行重寫，若適用)**：對照 `references/examples.md` 的轉換標準，將文字徹底重寫為極簡且充滿力量的直白文句。
+- [ ] **Step 5 — Verify (結果驗證)**：再次對重寫後的文字執行 `analyze-slop.js`，確保 Slop 密度降至 A+ 級（< 0.5%）。
+
+---
+
+## Detailed Guidelines
+
+### Step 1 — Perceive (感知環境)
+仔細分析使用者的請求與文本：
+1.  **語言檢索**：辨識主要語言是 **繁體中文 (Taiwan)** 還是 **英文**。
+2.  **場景分類**：
+    *   *一般文案/草稿*：加載 `phrases-zh.md`/`phrases-en.md` 與 `structures.md`。
+    *   *開發者文字 (註解/Commit/PR)*：加載 `dev-slop.md`。
+3.  **模式選擇**：
+    *   使用者問「這段文字有 AI 腔嗎？」或「幫我做文字審查」：進入 **Review 模式**。
+    *   使用者直接說「幫我重寫這段話」或「把 AI 腔消掉」：進入 **Rewrite 模式**。
+
+---
+
+### Step 2 — Reason & Load References
+動態加載該技能目錄下的專用知識庫。請根據 Step 1 的感知結果載入以下相對應的路徑：
+*   **英文通用**：`references/phrases-en.md`
+*   **中文通用**：`references/phrases-zh.md`
+*   **公式化結構**：`references/structures.md`
+*   **開發者專項**：`references/dev-slop.md`
+*   **Before/After 對照組**：`references/examples.md`
+
+---
+
+### Step 3 — Act: Review 模式 (診斷)
+1.  將使用者提供的文本寫入臨時檔案，或直接作為參數傳遞給統計腳本。
+2.  在終端非互動執行 `analyze-slop.js`：
+    ```bash
+    node skills/neo-stop-slop/scripts/analyze-slop.js --input "[使用者輸入的文本內容]" --format json
+    ```
+3.  解析腳本產出的 JSON 數據，擷取：
+    *   **Slop Density Score (Slop 密度分數)**
+    *   **Grade (評估等級)**
+    *   **Violations (檢出的贅詞清單)**
+4.  依據 Output Templates 呈現 Slop 診斷報告，列出違規行數、違規類型，並給出重構建议。
+
+---
+
+### Step 4 — Act: Rewrite 模式 (重寫)
+當需要重寫文本時，請遵循以下 6 條去 Slop 鋼鐵鐵律：
+1.  **消滅清喉嚨詞 (Cut fillers)**：徹底刪去「值得注意的是」、「不容忽視」、「Here's the thing」等起手式。
+2.  **用主動代替被動 (Active voice)**：確保每個句子都有具體的主語（如「人」或「具體組件」）在執行動作。避免擬人化 ("The code wants to...")。
+3.  **打碎公式化結構 (Break formulaic setups)**：去除「不是因為 X，而是因為 Y」這類刻意轉折的二元對立；刪除「試想一下：」等自我設問。
+4.  **用具體事實代替空泛形容詞 (Be specific)**：將「大幅提升效能、解決痛點」等空話，改寫為具體成效（例如「減少 80% 記憶體開銷」）。
+5.  **縮減字數至少 30%**：AI 腔的本質是稀釋資訊。優秀的文字會以最少字數傳達最大資訊量。
+6.  **適用開發者規則 (Apply Dev Conventions)**：若處理代碼註解或 Git Commit，嚴格套用 `dev-slop.md` 的精簡規則。
+
+---
+
+### Step 5 — Verify (結果驗證)
+1.  將重寫後的文字再次輸入檢測腳本：
+    ```bash
+    node skills/neo-stop-slop/scripts/analyze-slop.js --input "[重寫後的文本]" --format json
+    ```
+2.  確認 `slopDensityScore` **小於 0.5%**（評估等級達到 **A+**）。
+3.  向使用者呈交成果時，標明重寫前後的字數變化與 Slop 密度的巨大改善。
+
+---
+
+## Output Templates
+
+### 1. Review 診斷報告範本
+當使用者要求「審查/診斷」文字時，請格式化輸出如下：
+
+```markdown
+### 🔍 AI Slop 診斷報告
+
+*   **文本字數**: [總字數] 字
+*   **檢出 AI Tells 數量**: [檢出數] 處
+*   **Slop 密度分數**: **[密度Score]%** (每百字出現 [檢出數] 次)
+*   **評估等級**: **[等級]**
+
+#### ⚠️ 檢出細節與修改建議
+| 行數 | 檢出贅詞 | 類型 | 診斷與重構建议 |
+| :--- | :--- | :--- | :--- |
+| 第 X 行 | "值得注意的是" | 廢話起手式 | 刪除此段過渡句，直接陳述後續事實。 |
+| 第 Y 行 | "賦能生態系" | AI 濫用詞 | 替換為「提供技術支持」或「構建合作社群」。 |
+
+#### 📝 優化建議摘要
+1. [針對該文章結構的第一條具體調整建議]
+2. [針對副詞或被動語氣的第二條調整建議]
+```
+
+### 2. Rewrite 重寫成果範本
+當使用者要求「重寫」文字時，請格式化輸出如下：
+
+```markdown
+### ✨ 去 AI 腔重寫成果
+
+*   **字數變化**: [原始字數] 字 ➡️ **[重寫字數] 字 (縮減 [縮減比例]%)**
+*   **Slop 密度**: [原始密度]% ➡️ **0.0% (等級 A+ ✨)**
+
+---
+
+#### 📄 重寫後文本
+> [在此處寫入重寫後的極簡自然文本。保持排版清爽，避免任何 AI 贅字。]
+
+---
+
+#### 💡 關鍵重構解析
+1. **[重構點 1]**：將原始的「[Before 文字]」轉化為「[After 文字]」，去除了「[AI 腔]」並讓語氣更為[主動/直接]。
+2. **[重構點 2]**：刪除贅言，以具體事實「[具體內容]」代替空洞的「[Before 詞彙]」。
+```

package/skills/neo-stop-slop/evals/eval_queries.json

@@ -0,0 +1,30 @@
+[
+  {
+    "query": "幫我把這篇文案裡的 AI 腔調和贅詞消掉",
+    "should_trigger": true
+  },
+  {
+    "query": "Review this English draft and remove any AI writing patterns or filler words",
+    "should_trigger": true
+  },
+  {
+    "query": "這段 C# 代碼註解看起來很像 ChatGPT 寫的，幫我精簡一下",
+    "should_trigger": true
+  },
+  {
+    "query": "Write a Git commit message for this fix, but make it very concise and natural, no AI tells",
+    "should_trigger": true
+  },
+  {
+    "query": "如何用 Python 實作一個快速排序演算法？",
+    "should_trigger": false
+  },
+  {
+    "query": "幫我把這篇英文論文翻譯成繁體中文",
+    "should_trigger": false
+  },
+  {
+    "query": "這段程式碼有記憶體洩漏嗎？幫我做 Code Review",
+    "should_trigger": false
+  }
+]

package/skills/neo-stop-slop/evals/evals.json

@@ -0,0 +1,28 @@
+{
+  "skill_name": "neo-stop-slop",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "請幫我重寫這段文字，消除所有的 AI 腔贅詞，使其顯得極簡且直白：\n『值得注意的是，這是一把雙刃劍，不容忽視。總結來說，為企業賦能構建生態圈是至關重要的，我們需要深入探討背後的邏輯。』",
+      "expected_output": "重寫後的繁體中文文字。沒有『值得注意的是』、『雙刃劍』、『不容忽視』、『總結來說』、『賦能』、『生態圈』、『至關重要』、『深入探討』與『背後的邏輯』。文字字數大幅縮減，且意思直接生動。",
+      "assertions": [
+        "輸出文字中不包含『值得注意的是』",
+        "輸出文字中不包含『不容忽視』",
+        "輸出文字中不包含『至關重要』",
+        "輸出文字中不包含『生態圈』或『生態系』",
+        "文字語氣直白、精煉"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Rewrite the following technical blog draft to eliminate AI slop:\n'Here's the thing: building scalable systems is hard. Not because the technology is complex. Because human coordination is messy. Delving into microservices is pivotal to foster synergy, but make no mistake, it elevates complexity.'",
+      "expected_output": "Clean, direct English prose. No 'Here's the thing', 'Not because... Because...', 'delving', 'pivotal', 'foster synergy', 'make no mistake', 'elevates'. Mixes sentence lengths and uses active voice.",
+      "assertions": [
+        "The output does not contain 'Here\\'s the thing'",
+        "The output does not contain the word 'delve' or 'delving'",
+        "The output does not contain 'make no mistake' or 'foster synergy'",
+        "The response is direct and shorter than the original text"
+      ]
+    }
+  ]
+}

package/skills/neo-stop-slop/references/dev-slop.md

@@ -0,0 +1,77 @@
+# Developer Slop Removal (開發者專用 Slop 消除指南)
+
+身為開發者，程式碼註解 (Code Comments)、Git Commit 訊息、以及 PR (Pull Request) 說明書是我們最常寫文字的地方。然而，當使用 AI 輔助生成這些內容時，極易帶入累贅、客套且公式化的 AI Tells。這本指南能幫助您寫出如資深工程師般精煉、乾淨且精確的開發文字。
+
+---
+
+## 1. 程式碼註解與文檔 (Code Comments & Docstrings)
+AI 寫註解時往往過度解釋「這段代碼是做什麼的」，並充斥著無意義的過渡語。
+
+### 🚨 AI 腔特徵：
+*   **EN**: "This function is responsible for calculating..." / "Helper method to..." / "Please note that..."
+*   **ZH**: 「這個函式的主要職責是負責計算...」 / 「用於...的輔助方法」 / 「請注意，這個方法會...」
+
+### 💡 消除方法：
+**直接使用「動詞」開頭**。省略主詞與贅詞，專注於行為本身。
+
+*   *AI 腔 (EN)*:
+    ```typescript
+    // This function is responsible for retrieving the user profiles from the database.
+    // Please note that it returns null if the user does not exist in the system.
+    function getUser(id: string) { ... }
+    ```
+*   *重構 (EN)*:
+    ```typescript
+    // Fetch user profiles from database. Returns null if not found.
+    function getUser(id: string) { ... }
+    ```
+*   *AI 腔 (ZH)*:
+    ```csharp
+    /// <summary>
+    /// 這個類別的主要目的是用來處理支付流程，它整合了多個第三方 API。
+    /// 值得注意的是，在使用此類別之前必須先進行初始化。
+    /// </summary>
+    class PaymentProcessor { ... }
+    ```
+*   *重構 (ZH)*:
+    ```csharp
+    /// <summary>
+    /// 整合第三方 API 處理支付流程。使用前須完成初始化。
+    /// </summary>
+    class PaymentProcessor { ... }
+    ```
+
+---
+
+## 2. Git Commit 訊息 (Git Commit Messages)
+Git Commit 應是命令式、簡短且直接的。AI 喜歡使用完成時態與贅詞。
+
+### 🚨 AI 腔特徵：
+*   **Avoid**: "In this commit, we successfully implemented..." / "Add a new feature that permits the user to..." / "Fix a bug where the database will crash when..."
+*   **Avoid (ZH)**: 「在此 commit 中，我們成功實現了...」 / 「修復了一個當用戶輸入為空時資料庫會崩潰的 Bug。」
+
+### 💡 消除方法：
+**使用現在式、命令式動詞**。絕不說 "successfully"、"in this commit"。
+
+*   *AI 腔 (EN)*: `feat: successfully added authentication middleware to secure endpoints`
+*   *重構 (EN)*: `feat: add auth middleware`
+*   *AI 腔 (ZH)*: `fix: 在此提交中，修復了當資料庫連線失敗時會引發記憶體洩漏的嚴重問題`
+*   *重構 (ZH)*: `fix: 修正資料庫連線失敗時的記憶體洩漏`
+
+---
+
+## 3. Pull Request 說明書 (PR Descriptions)
+PR 說明書應該像一份高效的變更清單，而不是一份行銷簡報。
+
+### 🚨 AI 腔特徵：
+AI 產生的 PR 說明通常像這樣：
+> "This PR introduces a series of vital enhancements designed to elevate our developer experience and foster better synergy between our modules. We have carefully modified the configuration..."
+
+### 💡 消除方法：
+**直接使用項目符號 (Bullet points) 列出具體變更**。去掉所有宣傳性廢話。
+
+*   *AI 腔 (ZH)*:
+    > 「這是一個非常重要的 Pull Request，我們對身份驗證模組進行了重塑。值得注意的是，我們將舊有的 Token 驗證機制替換為更安全的 JWT。這無疑能為系統安全提供極佳的護城河，並解決過去用戶偶爾會遇到的登入痛點。」
+*   *重構 (ZH)*:
+    > - 替換舊有 Token 機制為 JWT，提升驗證安全性。
+    > - 修正特定邊界條件下用戶被強制登出的 Bug。

package/skills/neo-stop-slop/references/examples.md

@@ -0,0 +1,50 @@
+# Before/After Examples (中英文重寫對照範例)
+
+以下是不同情境下，AI 腔調（Before）與極簡、乾淨、生動文字（After）的重寫對照範例，並分析其修改重點。
+
+---
+
+## 範例 1：技術部落格或文章片段 (Technical Blog Post)
+
+### 🚨 Before (AI 腔):
+> "Here's the thing: building scalable systems is hard. Not because the technology itself is inherently complex, but because human coordination is incredibly messy. In this landscape, we often lean into sophisticated microservices architectures, but the truth is, they sometimes elevate complexity rather than foster synergy. Let that sink in."
+
+### 💡 After (直接、極簡):
+> "Building scalable systems is hard. Technology is manageable; human coordination isn't. While microservices promise scalability, they often introduce more complexity than they resolve."
+
+*   **修改重點**：
+    *   刪除廢話起手式 ("Here's the thing:", "but the truth is")。
+    *   重構二元對立結構 ("Not because... but because...") 為簡短的平行句對比。
+    *   移除無謂副詞 ("inherently", "incredibly", "sometimes")。
+    *   替換空洞的 AI 高頻詞彙 ("landscape", "lean into", "elevate", "foster synergy", "Let that sink in.")。
+
+---
+
+## 範例 2：功能與產品說明文件 (Product Description)
+
+### 🚨 Before (AI 腔):
+> 「值得注意的是，我們的全新自動化部署工具無疑是一項重大的遊戲規則改變者。它不僅為開發團隊賦能，更解決了持續整合中的關鍵痛點。這項改變是不容忽視的，因為它能將原本耗時的流程轉化為輕量級的無縫體驗。簡單來說，它重塑了我們的開發維度。」
+
+### 💡 After (事實陳述、乾淨俐落):
+> 「我們的全新部署工具能自動化持續整合流程，將平均部署時間縮短 80%，讓團隊專注於代碼開發，免於手動配置的繁瑣步驟。」
+
+*   **修改重點**：
+    *   刪除清喉嚨起手式 (「值得注意的是，...」、「簡單來說，...」)。
+    *   移除空洞的行銷與 AI 詞彙 (「遊戲規則改變者/Game-changer」、「賦能」、「痛點」、「重塑」、「維度」)。
+    *   刪除弱化詞與誇大修飾語 (「無疑是」、「是不容忽視的」)。
+    *   **以「具體事實與數據」代替「空泛讚美」**。將「輕量級的無縫體驗」改寫為實質成效「將平均部署時間縮短 80%」。
+
+---
+
+## 範例 3：業務聯絡與電子郵件 (Business Email)
+
+### 🚨 Before (AI 腔):
+> "I hope this email finds you well. I am writing to you today to see if we can circle back on our previous discussion regarding the system integration. As we navigate these challenges, I believe we are on the same page. Let's take a step back and unpack the key findings from our analysis, so we can double down on our commitment to moving forward."
+
+### 💡 After (效率溝通、直奔主題):
+> "I would like to follow up on our last discussion about system integration. Let's review our analysis findings next Tuesday to agree on the implementation steps."
+
+*   **修改重點**：
+    *   刪除陳腔濫調的問候語 ("I hope this email finds you well") 與宣告動作句 ("I am writing to you today to see if...")。
+    *   移除大量商業廢字與隱喻 ("circle back", "navigate these challenges", "on the same page", "take a step back", "unpack", "double down", "moving forward")。
+    *   **化被動為主動**，將空泛的「加倍承諾往前行」落實為具體的「下週二確認執行步驟」。

package/skills/neo-stop-slop/references/phrases-en.md

@@ -0,0 +1,79 @@
+# English Phrases to Remove (AI Tells)
+
+## 1. Throat-Clearing Openers
+These phrases announce that you are about to make a point, rather than simply making it. They add zero value. **Delete them and state the content directly.**
+
+*   "Here's the thing:"
+*   "Here's what [X]" / "Here's why [X]"
+*   "The uncomfortable truth is"
+*   "It turns out that"
+*   "The real [X] is"
+*   "Let me be clear"
+*   "The truth is," / "To be honest,"
+*   "I'll say it again:"
+*   "Can we talk about"
+*   "Here's what I find interesting"
+*   "Here's the problem though"
+*   "It is important to note that"
+*   "It goes without saying that"
+*   "Needless to say,"
+
+---
+
+## 2. Emphasis Crutches
+These are cheap rhetorical tricks used to manufacture profoundness or demand attention. **Delete them entirely; if your point is strong, the reader will feel it.**
+
+*   "Full stop." / "Period."
+*   "Let that sink in."
+*   "This matters because"
+*   "Make no mistake"
+*   "Here's why that matters"
+*   "Not all heroes wear capes."
+*   "At the end of the day,"
+
+---
+
+## 3. Classic AI High-Frequency Words
+AI has an extremely predictable vocabulary of "sophisticated" words. They make prose sound like a high school essay or marketing brochure. **Avoid them.**
+
+| Avoid | Meaning / Problem | Better Alternative |
+|---|---|---|
+| **Delve** | AI's absolute favorite word for "explore" | Explore, examine, study, look into, write |
+| **Tapestry** | Used to describe any complex system ("tapestry of life") | System, network, pattern, structure, mix |
+| **Testament** | "A testament to..." | Proof, sign, evidence, shows |
+| **Beacon** | "A beacon of..." | Example, guide, leader |
+| **Catalyst** | "A catalyst for..." | Cause, trigger, spark |
+| **Revolutionize** | Over-hyped marketing puffery | Improve, change, update |
+| **Synergy** | Empty business jargon | Cooperation, teamwork, alignment |
+| **Pivotal** | Overused emphasis | Key, crucial, important, major |
+| **Elevate** | "Elevate your writing..." | Improve, raise, sharpen |
+| **Foster** | "Foster a community..." | Build, grow, encourage |
+| **Demystify** | "Demystify the process..." | Explain, simplify |
+
+---
+
+## 4. Business & Tech Jargon
+Empty corporate words that mask a lack of specific meaning. **Replace with plain, active language.**
+
+| Avoid | Better Alternative |
+|---|---|
+| Navigate (challenges) | Handle, address, solve, face |
+| Unpack (analysis) | Explain, examine, discuss |
+| Lean into | Accept, embrace, adopt |
+| Landscape (context) | Situation, field, industry |
+| Game-changer | Significant, major, important |
+| Double down | Commit, increase, focus on |
+| Deep dive | Analysis, examination, review |
+| Take a step back | Reconsider, pause |
+| Moving forward | Next, from now on, in the future |
+| Circle back | Return to, revisit, talk later |
+| Leverage (as verb) | Use, apply |
+| Paradigm shift | Big change, transformation |
+
+---
+
+## 5. Adverbs & Hedges
+Adverbs (especially those ending in `-ly`) weaken active verbs. Hedges show lack of confidence. **Kill them all.**
+
+*   **Softeners/Hedges**: "really", "just", "literally", "basically", "essentially", "typically", "generally", "virtually".
+*   **Manufactured Intensifiers**: "extremely", "incredibly", "obviously", "absolutely", "completely", "deeply", "highly".

package/skills/neo-stop-slop/references/phrases-zh.md

@@ -0,0 +1,63 @@
+# 中文 AI Tells 贅詞庫 (Chinese Phrases to Remove)
+
+這些詞彙與片語是中文 AI（例如 Gemini, ChatGPT, Claude）在生成繁體中文時極高機率會使用的「AI 腔調」。它們會讓文章顯得累贅、空洞、像罐頭行銷文或八股論文。**請徹底清除它們，直接陳述事實。**
+
+---
+
+## 1. 廢話起手式與過渡詞 (Throat-Clearing Openers)
+AI 在進入主題前，非常喜歡使用這些空洞的過渡句來「清喉嚨」。**直接剪掉，從真正的內容開始寫起。**
+
+*   **「值得注意的是，...」** (AI 最愛) -> *直接說出值得注意的事實即可。*
+*   **「不得不說，...」**
+*   **「老實說，...」 /「坦白說，...」**
+*   **「不可否認的是，...」**
+*   **「毫無疑問地，...」**
+*   **「簡單來說，...」 /「換句話說，...」** -> *如果能簡單說，一開始就簡單說，不需要在前面加上這句。*
+*   **「總結來說，...」 /「綜上所述，...」** -> *直接下結論，刪除宣告語。*
+*   **「讓我們來看看...」 /「我們需要深入探討...」**
+*   **「正如我們所知，...」 /「眾所周知，...」**
+*   **「好消息是，...」 /「壞消息是，...」** (常見於美式 AI 翻譯腔)
+*   **「正如前面所提到的，...」**
+
+---
+
+## 2. 刻意渲染與誇大字眼 (Emphasis Crutches)
+AI 喜歡用誇張的語氣來強調某個普通的事情，這會降低文字的專業度與可信度。**刪除它們，讓事實自己說話。**
+
+*   **「不容忽視」 /「不容小覷」** -> *例如：「這項改變是不容忽視的。」改寫為：「這項改變會影響 [具體人事物]。」*
+*   **「扮演著舉足輕重的角色」 /「至關重要」** -> *過度誇大。改用「是關鍵」、「有助於」或直接說明其影響。*
+*   **「無疑是...」** -> *例如：「這無疑是最好的解決方案。」改寫為：「這是最好的解決方案。」*
+*   **「...的縮影」 /「...的完美體現」**
+*   **「令人驚嘆的」 /「令人興奮的」** -> *少用情緒煽動詞。*
+*   **「不言而喻」**
+
+---
+
+## 3. 經典 AI 高頻詞彙對照表 (Classic Chinese AI Slop)
+這些詞彙被 AI 嚴重濫用。它們聽起來很「高級」，實則模糊且空洞。**請替換為更具體、更自然的日常中文。**
+
+| 避免使用 (Avoid) | AI 濫用情境 | 推薦替換為 (Use instead) |
+| :--- | :--- | :--- |
+| **維度** | 「從這個維度來看...」 | 角度、方面、部分、層面 |
+| **畫卷** | 「展開一幅...的畫卷」 | 展現、呈現、面貌、前景 |
+| **雙刃劍** | 「這是一把雙刃劍」 | 有利有弊、有風險、存在副作用 |
+| **落地** | 「讓這個項目落地」 | 實施、執行、上線、實踐、落實 |
+| **賦能** | 「為企業賦能」 | 提供支持、協助、使能夠、強化 |
+| **生態系 / 生態圈** | 「構建一個生態系」 | 系統、環境、社群、平台、鏈條 |
+| **護城河** | 「建立技術護城河」 | 競爭優勢、防線、技術壁壘 |
+| **痛點** | 「為了解決用戶的痛點」 | 解決問題、困難、需求、不便之處 |
+| **閉環** | 「形成一個業務閉環」 | 流程完整、整合、循環 |
+| **抓手** | 「找到一個轉型的抓手」 | 切入點、著力點、突破口、方法 |
+| **背後** | 「這背後的邏輯是...」 | 原因在於、因為、原理是 |
+| **智能** | 「打造智能化的流程」 | 自動化、智慧型、電腦化 |
+| **重塑** | 「重塑我們的業務」 | 改變、重建、優化、改造 |
+
+---
+
+## 4. 無謂的副詞與弱化詞 (Adverbs & Hedges)
+中文副詞會讓語氣變得不確定、不堅定，或是顯得累贅。**精簡語句，去除贅字。**
+
+*   **弱化與不確定詞**：「基本上」、「原則上」、「實質上」、「可以說是」、「似乎」。
+*   **過度修飾副詞**：「非常」、「極其」、「相當」、「簡直」、「深刻地」。
+    *   *反例*：「我們需要深刻地理解這個問題。」
+    *   *正例*：「我們必須理解這個問題。」

package/skills/neo-stop-slop/references/structures.md

@@ -0,0 +1,86 @@
+# Formulaic AI Structures to Avoid (避開公式化句式指南)
+
+AI 的寫作不只單字重複，其「句式結構」與「邏輯推進方式」也非常公式化。以下是中英文中最常見的 AI 特徵句式，以及如何將其重構為更自然、直白的寫法。
+
+---
+
+## 1. 二元對立與刻意轉折 (Binary Contrasts / Telegraphed Reversals)
+AI 為了製造戲劇效果，極其喜歡先否定一個顯而易見的點，然後翻轉出主旨。這顯得刻意且不真誠。
+
+### 🚨 特徵句型：
+*   **EN**: "Not because X, but because Y." / "[X] isn't the problem. [Y] is." / "The answer isn't X. It's Y."
+*   **ZH**: 「不是因為 X，而是因為 Y。」 / 「問題不在於 X，而在於 Y。」 / 「答案不是 X，是 Y。」
+
+### 💡 解決方法：
+**直接陳述 Y。** 讀者不需要那個「否定 X」的助跑過程。
+
+*   *AI 腔 (EN)*: "Designing software is hard. Not because code is complex. Because requirements change. Let that sink in."
+*   *重構 (EN)*: "Designing software is hard because requirements change."
+*   *AI 腔 (ZH)*: 「寫測試很麻煩。不是因為工具不好用，而是因為我們沒有好的測試結構。」
+*   *重構 (ZH)*: 「混亂的測試結構讓寫測試變得很麻煩。」
+
+---
+
+## 2. 否定式表列 (Negative Listing / Rhetorical Striptease)
+在揭曉事物本質前，先列出一長串「它不是什麼」，像是在剝洋蔥。這會浪費讀者的時間。
+
+### 🚨 特徵句型：
+*   **EN**: "It wasn't X. It wasn't Y. It was Z." / "Not a blueprint, not a rulebook, but a compass."
+*   **ZH**: 「這不是指引，也不是指南，而是一盞明燈。」 / 「這無關技術，無關架構，關乎於人。」
+
+### 💡 解決方法：
+**直接寫出 Z。** 省去多餘的鋪墊。
+
+*   *AI 腔 (EN)*: "This project is not a replacement for Git, nor is it a new server. It is a local CLI tool."
+*   *重構 (EN)*: "This project is a local CLI tool."
+*   *AI 腔 (ZH)*: 「這項改進無關乎伺服器硬體，也無關乎頻寬，而是演算法的優化。」
+*   *重構 (ZH)*: 「這項性能提升來自演算法優化。」
+
+---
+
+## 3. 刻意破碎的短句 (Dramatic Fragmentation / Performative Simplicity)
+AI 經常使用「名詞。這就夠了。」或「X。然後是 Y。最後是 Z。」等破碎句型來裝作高深、有權威感，但實際上讀起來非常做作。
+
+### 🚨 特徵句型：
+*   **EN**: "[Noun]. That's it. That's the [thing]." / "X. And Y. And Z."
+*   **ZH**: 「[名詞]。就這樣。這就是 [事物]。」 / 「極簡。這就是我們追求的。」
+
+### 💡 解決方法：
+**使用連貫的完整句子。** 信任內容本身的力量，不需要靠格式演戲。
+
+*   *AI 腔 (EN)*: "Continuous integration. That's it. That's the secret."
+*   *重構 (EN)*: "Continuous integration is the secret to stable deploys."
+*   *AI 腔 (ZH)*: 「高內聚，低耦合。這就是優秀代碼的精髓。」
+*   *重構 (ZH)*: 「優秀代碼通常具有高內聚、低耦合的特性。」
+
+---
+
+## 4. 虛假主動權 / 擬人化 (False Agency / Anthropomorphism)
+AI 喜歡將「無生命的事物」或「抽象概念」寫得像是有自主意識的活人。這在技術寫作中顯得滑稽且不精確。
+
+### 🚨 特徵句型：
+*   **EN**: "The code wants to do X." / "The compiler is trying to tell us..." / "The library brings peace."
+*   **ZH**: 「這行代碼渴望告訴我們...」 / 「編譯器正在向我們抗議...」 / 「這個錯誤默默地守護著系統。」
+
+### 💡 解決方法：
+**改用客觀、事實性的描述。**
+
+*   *AI 腔 (EN)*: "The garbage collector is fighting to keep the memory clean."
+*   *重構 (EN)*: "The garbage collector frees unused memory."
+*   *AI 腔 (ZH)*: 「這個函式庫試圖去解決多線程衝突的問題。」
+*   *重構 (ZH)*: 「這個函式庫解決了多線程衝突。」
+
+---
+
+## 5. 設問句與自我解答 (Rhetorical Setups & Socratic Posturing)
+AI 很喜歡用「如果...會怎樣？」或「想像一下：」等問題來作為段落開頭，然後自己回答。這在非教學性文章中顯得居高臨下。
+
+### 🚨 特徵句型：
+*   **EN**: "What if we could [X]?" / "Think about it:" / "Let's be real:"
+*   **ZH**: 「如果我們能自動化這一切，會怎麼樣？」 / 「試想一下：」 / 「老實說：」
+
+### 💡 解決方法：
+**直接陳述解決方案或事實。**
+
+*   *AI 腔 (ZH)*: 「如果我們能每天節省一小時的部署時間會怎樣？這就是 Docker 的用處。」
+*   *重構 (ZH)*: 「Docker 能將每日部署時間縮短一小時。」

package/skills/neo-stop-slop/scripts/analyze-slop.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+
+/**
+ * Neo Stop Slop - CLI Analyzer
+ * 
+ * Analyze text or markdown files for AI writing patterns (Slop) and calculate Slop Density.
+ * Strictly non-interactive, accepts arguments, separates stdout/stderr.
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+// Define high-frequency AI Tells & Slop Patterns
+const ENGLISH_PATTERNS = [
+  // Throat-clearing
+  { phrase: "here's the thing", category: "Throat-Clearing", regex: /\bhere's the thing\b/gi },
+  { phrase: "the uncomfortable truth is", category: "Throat-Clearing", regex: /\bthe uncomfortable truth is\b/gi },
+  { phrase: "it turns out that", category: "Throat-Clearing", regex: /\bit turns out that\b/gi },
+  { phrase: "let me be clear", category: "Throat-Clearing", regex: /\blet me be clear\b/gi },
+  { phrase: "the truth is,", category: "Throat-Clearing", regex: /\bthe truth is\b/gi },
+  { phrase: "it is important to note that", category: "Throat-Clearing", regex: /\bit is important to note that\b/gi },
+  { phrase: "it goes without saying that", category: "Throat-Clearing", regex: /\bit goes without saying that\b/gi },
+  // Emphasis crutches
+  { phrase: "full stop.", category: "Emphasis Crutch", regex: /\bfull stop\b/gi },
+  { phrase: "let that sink in", category: "Emphasis Crutch", regex: /\blet that sink in\b/gi },
+  { phrase: "make no mistake", category: "Emphasis Crutch", regex: /\bmake no mistake\b/gi },
+  // High-frequency AI Slop Words
+  { phrase: "delve", category: "AI Slop Word", regex: /\bdelve\b/gi },
+  { phrase: "tapestry", category: "AI Slop Word", regex: /\btapestry\b/gi },
+  { phrase: "testament", category: "AI Slop Word", regex: /\btestament\b/gi },
+  { phrase: "beacon", category: "AI Slop Word", regex: /\bbeacon\b/gi },
+  { phrase: "catalyst", category: "AI Slop Word", regex: /\bcatalyst\b/gi },
+  { phrase: "revolutionize", category: "AI Slop Word", regex: /\brevolutionize\b/gi },
+  { phrase: "synergy", category: "AI Slop Word", regex: /\bsynergy\b/gi },
+  { phrase: "foster", category: "AI Slop Word", regex: /\bfoster\b/gi },
+  { phrase: "demystify", category: "AI Slop Word", regex: /\bdemystify\b/gi },
+  // Business jargon
+  { phrase: "navigate challenges", category: "Jargon", regex: /\bnavigate (?:the )?challenges\b/gi },
+  { phrase: "unpack", category: "Jargon", regex: /\bunpack\b/gi },
+  { phrase: "lean into", category: "Jargon", regex: /\blean into\b/gi },
+  { phrase: "double down", category: "Jargon", regex: /\bdouble down\b/gi },
+  { phrase: "deep dive", category: "Jargon", regex: /\bdeep dive\b/gi },
+  { phrase: "paradigm shift", category: "Jargon", regex: /\bparadigm shift\b/gi }
+];
+
+const CHINESE_PATTERNS = [
+  // 廢話起手式
+  { phrase: "值得注意的是", category: "起手式", regex: /值得注意的是/g },
+  { phrase: "不得不說", category: "起手式", regex: /不得不說/g },
+  { phrase: "不可否認的是", category: "起手式", regex: /不可否認的是/g },
+  { phrase: "毫無疑問地", category: "起手式", regex: /毫無疑問地?/g },
+  { phrase: "簡單來說", category: "起手式", regex: /簡單來說/g },
+  { phrase: "總結來說", category: "起手式", regex: /總結來說/g },
+  { phrase: "綜上所述", category: "起手式", regex: /綜上所述/g },
+  { phrase: "讓我們來看看", category: "起手式", regex: /讓我們來看看/g },
+  { phrase: "我們需要深入探討", category: "起手式", regex: /我們需要深入探討/g },
+  // 誇大字眼
+  { phrase: "不容忽視", category: "誇大渲染", regex: /不容忽視/g },
+  { phrase: "不容小覷", category: "誇大渲染", regex: /不容小覷/g },
+  { phrase: "扮演著舉足輕重的角色", category: "誇大渲染", regex: /扮演著舉足輕重的角色/g },
+  { phrase: "至關重要", category: "誇大渲染", regex: /至關重要/g },
+  { phrase: "無疑是", category: "誇大渲染", regex: /無疑是/g },
+  // AI 高頻詞彙
+  { phrase: "維度", category: "AI 濫用詞", regex: /維度/g },
+  { phrase: "畫卷", category: "AI 濫用詞", regex: /畫卷/g },
+  { phrase: "雙刃劍", category: "AI 濫用詞", regex: /雙刃劍/g },
+  { phrase: "落地", category: "AI 濫用詞", regex: /落地/g },
+  { phrase: "賦能", category: "AI 濫用詞", regex: /賦能/g },
+  { phrase: "生態系/生態圈", category: "AI 濫用詞", regex: /生態[系圈]/g },
+  { phrase: "護城河", category: "AI 濫用詞", regex: /護城河/g },
+  { phrase: "痛點", category: "AI 濫用詞", regex: /痛點/g },
+  { phrase: "閉環", category: "AI 濫用詞", regex: /閉環/g },
+  { phrase: "抓手", category: "AI 濫用詞", regex: /抓手/g },
+  { phrase: "背後的邏輯", category: "AI 濫用詞", regex: /背後的邏輯/g },
+  { phrase: "重塑", category: "AI 濫用詞", regex: /重塑/g },
+  // 贅詞副詞
+  { phrase: "基本上", category: "贅字副詞", regex: /基本上/g },
+  { phrase: "深刻地", category: "贅字副詞", regex: /深刻地/g }
+];
+
+function showHelp() {
+  console.warn(`
+Neo Stop Slop Analyzer - 檢測並計算文本中的 AI Tells / Slop 密度。
+
+用法:
+  node analyze-slop.js [選項]
+
+選項:
+  -f, --file <路徑>      指定要分析的文字或 Markdown 檔案路徑。
+  -i, --input <文字>     直接傳入要分析的文字字串。
+  -o, --output <路徑>    將結果寫入指定檔案 (預設為輸出至 stdout)。
+  --format <格式>        輸出格式: "text" (預設，易讀報告) 或 "json" (程式解析用)。
+  -h, --help             顯示此說明訊息。
+
+範例:
+  node analyze-slop.js --file src/README.md --format json
+  node analyze-slop.js --input "Here's the thing: Not because it's hard. But because it's necessary. Full stop."
+`);
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    file: null,
+    input: null,
+    output: null,
+    format: 'text' // text or json
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '-h' || arg === '--help') {
+      showHelp();
+      process.exit(0);
+    } else if (arg === '-f' || arg === '--file') {
+      options.file = args[++i];
+    } else if (arg === '-i' || arg === '--input') {
+      options.input = args[++i];
+    } else if (arg === '-o' || arg === '--output') {
+      options.output = args[++i];
+    } else if (arg === '--format') {
+      options.format = args[++i];
+      if (options.format !== 'text' && options.format !== 'json') {
+        console.error(`[ERROR] 不支援的輸出格式: ${options.format}. 請使用 "text" 或 "json"。`);
+        process.exit(1);
+      }
+    } else {
+      console.error(`[ERROR] 未知參數: ${arg}`);
+      showHelp();
+      process.exit(1);
+    }
+  }
+
+  return options;
+}
+
+function calculateWordCount(text) {
+  // Simple word count: English words + Chinese characters
+  const enWords = text.match(/[a-zA-Z]+/g) || [];
+  const zhChars = text.match(/[\u4e00-\u9fa5]/g) || [];
+  return enWords.length + zhChars.length;
+}
+
+function analyzeText(text) {
+  const lines = text.split('\n');
+  const violations = [];
+  let matchCount = 0;
+
+  // Process English and Chinese patterns
+  const allPatterns = [...ENGLISH_PATTERNS, ...CHINESE_PATTERNS];
+
+  lines.forEach((lineText, lineIndex) => {
+    const lineNumber = lineIndex + 1;
+
+    allPatterns.forEach(pattern => {
+      // Reset regex index due to 'g' flag
+      pattern.regex.lastIndex = 0;
+      let match;
+      while ((match = pattern.regex.exec(lineText)) !== null) {
+        matchCount++;
+        violations.push({
+          line: lineNumber,
+          matchedText: match[0],
+          phrase: pattern.phrase,
+          category: pattern.category,
+          lineContent: lineText.trim()
+        });
+      }
+    });
+  });
+
+  const totalWords = calculateWordCount(text);
+  // Calculate Slop Density Score (violations per 100 words)
+  const slopDensity = totalWords > 0 ? parseFloat(((matchCount / totalWords) * 100).toFixed(2)) : 0;
+
+  // Grade based on density
+  let grade = 'A+ (極其精煉，無 AI 腔)';
+  if (slopDensity > 10) {
+    grade = 'F (充斥大量 AI Tells，廢話連篇)';
+  } else if (slopDensity > 5) {
+    grade = 'D (AI 腔過重，亟需重寫)';
+  } else if (slopDensity > 2) {
+    grade = 'C (有明顯 AI Tells，建議修改)';
+  } else if (slopDensity > 0.5) {
+    grade = 'B (有些許贅詞，品質尚可)';
+  }
+
+  return {
+    metrics: {
+      totalWords,
+      totalViolations: matchCount,
+      slopDensityScore: slopDensity,
+      grade
+    },
+    violations
+  };
+}
+
+function formatTextReport(result, sourceName) {
+  let output = `==================================================\n`;
+  output += `   NEO STOP SLOP - AI TELLS 檢測報告\n`;
+  output += `==================================================\n`;
+  output += `來源名稱: ${sourceName}\n`;
+  output += `總字詞數: ${result.metrics.totalWords}\n`;
+  output += `檢出 AI 贅詞數: ${result.metrics.totalViolations}\n`;
+  output += `Slop 密度分數: ${result.metrics.slopDensityScore}% (每百字出現次數)\n`;
+  output += `評估等級: ${result.metrics.grade}\n`;
+  output += `--------------------------------------------------\n`;
+
+  if (result.violations.length === 0) {
+    output += `✨ 太棒了！您的文字極其精煉，沒有檢測到任何 AI 贅詞特徵！\n`;
+  } else {
+    output += `檢出細節 (前 30 筆違規)：\n\n`;
+    const displayList = result.violations.slice(0, 30);
+    displayList.forEach(v => {
+      output += `[第 ${v.line} 行] 【${v.category}】檢出: "${v.matchedText}" (預設關鍵字: "${v.phrase}")\n`;
+      output += `  上下文: "${v.lineContent}"\n\n`;
+    });
+
+    if (result.violations.length > 30) {
+      output += `... 還有其他 ${result.violations.length - 30} 處違規未列出。\n`;
+    }
+  }
+  output += `==================================================\n`;
+  return output;
+}
+
+function main() {
+  const options = parseArgs();
+
+  let sourceContent = '';
+  let sourceName = '';
+
+  if (options.file) {
+    const absolutePath = path.resolve(options.file);
+    if (!fs.existsSync(absolutePath)) {
+      console.error(`[ERROR] 找不到指定的檔案: ${options.file}`);
+      process.exit(1);
+    }
+    sourceContent = fs.readFileSync(absolutePath, 'utf8');
+    sourceName = path.basename(options.file);
+  } else if (options.input !== null) {
+    sourceContent = options.input;
+    sourceName = '直接傳入字串';
+  } else {
+    console.error(`[ERROR] 請提供 --file <路徑> 或 --input <文字>。`);
+    showHelp();
+    process.exit(1);
+  }
+
+  // Run analysis
+  console.error(`[INFO] 正在分析 "${sourceName}" 中的 AI 腔贅詞...`);
+  const result = analyzeText(sourceContent);
+
+  // Generate output string
+  let outputResult = '';
+  if (options.format === 'json') {
+    outputResult = JSON.stringify(result, null, 2);
+  } else {
+    outputResult = formatTextReport(result, sourceName);
+  }
+
+  // Handle output destination
+  if (options.output) {
+    const outputPath = path.resolve(options.output);
+    console.error(`[INFO] 正在將分析結果寫入: ${outputPath}`);
+    fs.writeFileSync(outputPath, outputResult, 'utf8');
+  } else {
+    // Print to stdout
+    process.stdout.write(outputResult + '\n');
+  }
+
+  console.error(`[INFO] 分析完成。`);
+}
+
+main();