187 lines
4.5 KiB
Markdown
187 lines
4.5 KiB
Markdown
## AI 写作检查
|
||
|
||
检测 AI 生成文本的机械化模式，并提供更自然的中文改进建议。
|
||
|
||
### 使用方法
|
||
|
||
```bash
|
||
/ai-writing-check [选项]
|
||
```
|
||
|
||
### 选项
|
||
|
||
- 无参数 : 分析当前文件或选中的文本
|
||
- `--file <path>` : 分析特定文件
|
||
- `--dir <path>` : 批量分析目录内的文件
|
||
- `--severity <level>` : 检测级别 (all/high/medium)
|
||
- `--fix` : 自动修复检测到的模式
|
||
|
||
### 基本示例
|
||
|
||
```bash
|
||
# 检查文件的 AI 痕迹
|
||
cat README.md
|
||
/ai-writing-check
|
||
「检查这个文档的 AI 痕迹并提供改进方案」
|
||
|
||
# 分析特定文件
|
||
/ai-writing-check --file docs/guide.md
|
||
「检测 AI 风格的表达并建议自然的表达方式」
|
||
|
||
# 扫描整个项目
|
||
/ai-writing-check --dir . --severity high
|
||
「只报告项目中重要的 AI 痕迹问题」
|
||
```
|
||
|
||
### 检测模式
|
||
|
||
#### 1. 列表格式的机械化模式
|
||
|
||
```markdown
|
||
检测示例：
|
||
|
||
- **重要**: 这是重要的项目
|
||
- 已完成的项目 (带勾选标记)
|
||
- 热门话题 (带火焰表情)
|
||
- 准备启动 (带火箭表情)
|
||
|
||
改进示例：
|
||
|
||
- 重要项目：这是重要的项目
|
||
- 已完成的项目
|
||
- 热门话题
|
||
- 准备启动
|
||
```
|
||
|
||
#### 2. 夸张和炒作表达
|
||
|
||
```markdown
|
||
检测示例：
|
||
革命性的技术将改变行业。
|
||
这完全解决了问题。
|
||
像魔法一样运行。
|
||
|
||
改进示例：
|
||
有效的技术将为行业带来变化。
|
||
解决了许多问题。
|
||
运行流畅。
|
||
```
|
||
|
||
#### 3. 机械化的强调模式
|
||
|
||
```markdown
|
||
检测示例：
|
||
**想法**: 有新的提议 (带灯泡表情)
|
||
**注意**: 重要警告事项 (带警告表情)
|
||
|
||
改进示例：
|
||
想法：有新的提议
|
||
注意事项：重要警告事项
|
||
```
|
||
|
||
#### 4. 冗余的技术写作
|
||
|
||
```markdown
|
||
检测示例：
|
||
首先先进行设置。
|
||
可以使用这个工具。
|
||
大幅提升性能。
|
||
|
||
改进示例：
|
||
首先进行设置。
|
||
可以使用这个工具。
|
||
性能提升 30%。
|
||
```
|
||
|
||
### 与 Claude 配合
|
||
|
||
```bash
|
||
# 文档整体的 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 痕迹并创建摘要」
|
||
```
|
||
|
||
### 详细示例
|
||
|
||
```bash
|
||
# 改进前后对比
|
||
/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. 分阶段改进计划」
|
||
```
|
||
|
||
### 高级用法
|
||
|
||
```bash
|
||
# 应用自定义规则
|
||
/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](https://github.com/textlint-ja/textlint-rule-preset-ai-writing) 的规则集创建。这是一个 textlint 规则预设，用于检测 AI 生成文本的机械化模式，促进更自然的表达。
|