/style-ai-writting

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 会进行以下处理：

1. 模式检测: 从指定的文件或文本中检测 AI 风格的模式
2. 具体修改建议: 为每个问题提供带行号的修改方案
3. --fix 模式: 自动修复检测到的模式，并显示结果摘要
4. 报告生成: 提供检测数、改进优先级、修改前后对比

Claude 会读取实际文件内容，基于 textlint-rule-preset-ai-writing 的规则进行分析。

参考

此命令参考了 textlint-rule-preset-ai-writing 的规则集创建。这是一个 textlint 规则预设，用于检测 AI 生成文本的机械化模式，促进更自然的表达。