wasabeef 偵測 AI 文字機械模式並改進為自然語言
檢測 AI 生成文本的機械化模式，並提供更自然的中文改進建議。
使用方法
/ai-writing-check [選項]
選項
- 無參數 : 分析當前文件或選中的文本
--file <path>: 分析特定文件--dir <path>: 批量分析目錄內的文件--severity <level>: 檢測級別 (all/high/medium)--fix: 自動修復檢測到的模式
基本示例
# 檢查文件的 AI 痕迹
cat README.md
/ai-writing-check
「檢查這個文檔的 AI 痕迹並提供改進方案」
# 分析特定文件
/ai-writing-check --file docs/guide.md
「檢測 AI 風格的表達並建議自然的表達方式」
# 掃描整個項目
/ai-writing-check --dir . --severity high
「只報告項目中重要的 AI 痕迹問題」
檢測模式
1. 列表格式的機械化模式
檢測示例：
- **重要**: 這是重要的項目
- 已完成的項目 (带勾選標記)
- 熱門話題 (带火焰表情)
- 準備啟動 (带火箭表情)
改進示例：
- 重要項目：這是重要的項目
- 已完成的項目
- 熱門話題
- 準備啟動
2. 夸张和炒作表達
檢測示例：
革命性的技術將改變行業。
這完全解決了問題。
像魔法一樣運行。
改進示例：
有效的技術將為行業带來變化。
解決了许多問題。
運行流畅。
3. 機械化的強調模式
檢測示例：
**想法**: 有新的提議 (带灯泡表情)
**注意**: 重要警告事項 (带警告表情)
改進示例：
想法：有新的提議
注意事項：重要警告事項
4. 冗余的技術寫作
檢測示例：
首先先進行設置。
可以使用這個工具。
大幅提升性能。
改進示例：
首先進行設置。
可以使用這個工具。
性能提升 30%。
與 Claude 配合
# 文檔整體的 AI 痕迹分析
cat article.md
/ai-writing-check
「從以下角度分析並提供改進方案：
1. 機械化表達的檢測
2. 自然中文的修改建議
3. 按優先級排列的改進列表」
# 聚焦特定模式
/ai-writing-check --file blog.md
「特別關注夸张表達和冗余表達並提供改進建議」
# 批量檢查多個文件
find . -name "*.md" -type f
/ai-writing-check --dir docs/
「分析整個文檔的 AI 痕迹並創建摘要」
詳细示例
# 改進前後對比
/ai-writing-check --file draft.md
「檢測 AI 風格的表達，按以下格式展示：
- 問題位置 (带行号)
- 問題類型和原因
- 具體改進方案
- 改進效果」
# 自動修復模式
/ai-writing-check --file report.md --fix
「自動修復檢測到的模式並報告結果」
# 項目 AI 痕迹報告
/ai-writing-check --dir . --severity all
「分析整個項目的 AI 痕迹：
1. 統計資訊 (按模式分類的檢測數)
2. 問題最多的文件 TOP 5
3. 改進優先級矩阵
4. 分阶段改進計劃」
高級用法
# 應用自定義規則
/ai-writing-check --file spec.md
「作為技術規格書，使用以下额外標準檢查：
- 模糊表達 (適当的、根據需要)
- 缺乏具體性 (高速 → 具體數值)
- 術語使用不一致」
# CI/CD 集成檢查
/ai-writing-check --dir docs/ --severity high
「以可在 GitHub Actions 執行的格式輸出結果：
- 錯誤數和文件名
- 需要修復的行号
- exit code 設置」
# 風格指南合規檢查
/ai-writing-check --file manual.md
「基于公司風格指南進行额外檢查：
- 敬語使用 (統一礼貌用語)
- 專業術語的適当使用
- 對讀者的考虑」
注意事項
- AI 痕迹的判定因上下文而異，建議仅作參考
- 根據文檔類型 (技術文檔、博客、手冊等) 調整標準
- 不必接受所有建議，選擇合適的即可
--fix選項會自動修復檢測到的模式
命令執行時的行為
執行 /ai-writing-check 命令時，Claude 會進行以下處理：
- 模式檢測: 從指定的文件或文本中檢測 AI 風格的模式
- 具體修改建議: 為每個問題提供带行号的修改方案
- --fix 模式: 自動修復檢測到的模式，並顯示結果摘要
- 報告生成: 提供檢測數、改進優先級、修改前後對比
Claude 會讀取實際文件內容，基于 textlint-rule-preset-ai-writing 的規則進行分析。
參考
此命令參考了 textlint-rule-preset-ai-writing 的規則集創建。這是一個 textlint 規則預設，用于檢測 AI 生成文本的機械化模式，促進更自然的表達。