ai-check-skills

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# AI-check Skills

AI-check Skills 是一个面向 Codex、Claude Code、OpenCode 等 AI 编程助手的开源 Skill，用于
Word/DOCX 论文 AI 率检测报告生成、自动化降 AI 率、重复率/AI 写作风格清理与确认后改写。

> 该功能是 [EasyIdea 科研工作台](https://honeymeta.com/easyidea) 的一小部分。如果你需要完整
> 的论文写作、DOCX 工作台、报告导入、标注修改、批量审阅和一键采纳/放弃能力，欢迎下载使用：
> https://honeymeta.com/easyidea

![AI-check report preview](https://github.com/HoneyMeta/ai-check-skills/raw/HEAD/docs/assets/ai-check-report-preview.png?v=20260628)

## 功能亮点

- 从 `.docx` 中读取正文、摘要、结论等论文内容。
- 自动切分长文本，生成适合 AI 助手逐段判断的 chunk。
- 提取可解释的 AI 写作风险信号，例如模板化表达、连接词密集、泛化套话、句式节奏过于均匀等。
- 同时记录缓和信号，例如引用编号、实验指标、模型/方法名、领域方法细节和定量结果支撑。
- 由当前 AI 助手在可见对话中判断 `aigcValue`、verdict、reason 和 signals，脚本本身不黑箱打分。
- 生成美观、可选择文本的 AI 率检测 PDF/HTML 报告。
- 在用户确认后，将改写方案写入新的 DOCX，不会原地修改原文档。
- 支持 Codex、Claude Code、OpenCode，以及其他能运行本地脚本的 agent runtime。

## 独立 DOCX/PDF 管线

AI-check Skills 不依赖 LibreOffice、`soffice`、Microsoft Word 自动化、DOCX 转 PDF 渲染或截图渲染。

- DOCX 解析和写回：`python-docx`
- PDF 报告生成：`reportlab`
- 确定性信号提取：仓库内置 Python 脚本

脚本不会调用 AI 模型，也不会自行输出最终 AI 概率。AI 助手负责逐段判断与改写，用户可以看到判断依据。

## 安装

在 Claude Code、Codex、OpenCode 等 AI 编程助手中发送：

```text
帮我安装 HoneyMeta/ai-check-skills
```

安装完成后，重启 Claude Code / Codex / OpenCode 等客户端，让新安装的 skill 生效。
如果客户端提示缺少依赖，让 AI 助手按仓库说明自动安装即可。

## 目录结构

```text
ai-check/
  SKILL.md
  agents/openai.yaml
  scripts/
    ai_check.py
    ai_rewrite_docx.py
  references/
    ai_rate_signals.md
    report_format.md
  assets/
    report_template.html
docs/
  assets/
    ai-check-report-preview.png
tests/
  test_ai_check.py
```

## 快速开始

在 AI 编程助手中发送：

```text
使用 ai-check-skills 帮我为 XXXX（文档路径）生成 AI率检测报告
```

例如：

```text
使用 ai-check-skills 帮我为 F:\papers\main.docx 生成 AI率检测报告
```

AI 助手会读取 DOCX，生成可解释的片段信号，并输出：

- 可选择文本的 PDF 报告
- HTML 报告
- summary JSON

如果需要继续降 AI 率，可以在报告生成后让 AI 助手先列出改写方案；用户确认后再写入新的 DOCX。
原始 DOCX 不会被原地修改。

## 示例提示词

- `使用 ai-check-skills 帮我为 F:\papers\main.docx 生成 AI率检测报告`
- `根据 AI-check 报告，先给我看需要修改的片段和改写方案，确认后再写出新的 Word。`
- `只检测，不改 Word。`

## 注意事项

- 报告仅供参考。
- 不要宣称结果等同于知网、维普、Turnitin 或其他闭源检测平台。
- 改写时应保留事实、术语、公式、数字、引用编号和结论方向。
- 如果原文缺少证据，不要编造实验、数据、案例或引用；应降低语气、补充边界，或使用已有上下文。

## License

MIT

## English

AI-check Skills is an open-source Codex/OpenCode-style skill for AI-rate report generation,
automated AI-writing reduction, and academic repetition/AI-writing style cleanup. It generates a
polished, selectable-text PDF/HTML report from a Word document, then applies confirmed revisions to
a new DOCX only after user approval.

This project is a small part of [EasyIdea Research Workbench](https://honeymeta.com/easyidea). For a
full research-writing workflow with a live DOCX workbench, report import, annotations, batch review,
and one-click accept/reject, download EasyIdea: https://honeymeta.com/easyidea

### Highlights

- Reads `.docx` files and extracts body, abstract, and conclusion text.
- Splits long academic text into reviewable chunks.
- Extracts explainable AI-writing signals such as template phrases, dense connectors, generic
  claims, and uniform sentence rhythm.
- Keeps mitigating evidence such as citations, metrics, method names, domain details, and
  quantitative results.
- Lets the active AI assistant judge `aigcValue`, verdict, reason, and signals in the visible
  conversation.
- Generates a polished AI-rate report as HTML and selectable-text PDF.
- Applies user-confirmed replacements to a new DOCX without modifying the original document.
- Supports Codex, Claude Code, OpenCode, and similar agent runtimes that can run local scripts.

### Independent Pipeline

AI-check Skills does not require LibreOffice, `soffice`, Microsoft Word automation, DOCX-to-PDF
rendering, or screenshot rendering.

- DOCX parsing and rewriting: `python-docx`
- PDF report generation: `reportlab`
- Deterministic signal extraction: bundled Python scripts

The scripts do not call AI models and do not produce a final AI probability by themselves. The AI
assistant remains responsible for judgment and rewriting so the user can see the reasoning.

### Install

Ask your AI coding assistant to install this repository as a skill:

```text
Install HoneyMeta/ai-check-skills
```

After installation, restart Claude Code / Codex / OpenCode, or the assistant runtime you use, so the
new skill is loaded.

### Quick Start

Send a prompt like:

```text
Use ai-check-skills to generate an AI-rate report for C:\papers\main.docx.
```

For Chinese workflows, you can use:

```text
使用 ai-check-skills 帮我为 XXXX（文档路径）生成 AI率检测报告
```

The assistant will scan the DOCX, produce an explainable PDF/HTML report, and only write a rewritten
DOCX after you approve the replacement plan.

### Safety Notes

- The report is for reference only.
- Do not claim that it is equivalent to CNKI, VIP, Turnitin, or another closed detector.
- Preserve facts, terminology, formulas, numbers, citation markers, and conclusion direction during
  rewriting.
- If the source lacks evidence, do not invent experiments, data, cases, or citations.

AI-check Skills

AI-check Skills 是一个面向 Codex、Claude Code、OpenCode 等 AI 编程助手的开源 Skill，用于 Word/DOCX 论文 AI 率检测报告生成、自动化降 AI 率、重复率/AI 写作风格清理与确认后改写。

该功能是 EasyIdea 科研工作台的一小部分。如果你需要完整的论文写作、DOCX 工作台、报告导入、标注修改、批量审阅和一键采纳/放弃能力，欢迎下载使用： https://honeymeta.com/easyidea

AI-check report preview

功能亮点

从 .docx 中读取正文、摘要、结论等论文内容。
自动切分长文本，生成适合 AI 助手逐段判断的 chunk。
提取可解释的 AI 写作风险信号，例如模板化表达、连接词密集、泛化套话、句式节奏过于均匀等。
同时记录缓和信号，例如引用编号、实验指标、模型/方法名、领域方法细节和定量结果支撑。
由当前 AI 助手在可见对话中判断 aigcValue、verdict、reason 和 signals，脚本本身不黑箱打分。
生成美观、可选择文本的 AI 率检测 PDF/HTML 报告。
在用户确认后，将改写方案写入新的 DOCX，不会原地修改原文档。
支持 Codex、Claude Code、OpenCode，以及其他能运行本地脚本的 agent runtime。

独立 DOCX/PDF 管线

AI-check Skills 不依赖 LibreOffice、soffice、Microsoft Word 自动化、DOCX 转 PDF 渲染或截图渲染。

DOCX 解析和写回：python-docx
PDF 报告生成：reportlab
确定性信号提取：仓库内置 Python 脚本

脚本不会调用 AI 模型，也不会自行输出最终 AI 概率。AI 助手负责逐段判断与改写，用户可以看到判断依据。

安装

在 Claude Code、Codex、OpenCode 等 AI 编程助手中发送：

帮我安装 HoneyMeta/ai-check-skills

安装完成后，重启 Claude Code / Codex / OpenCode 等客户端，让新安装的 skill 生效。如果客户端提示缺少依赖，让 AI 助手按仓库说明自动安装即可。

目录结构

ai-check/
  SKILL.md
  agents/openai.yaml
  scripts/
    ai_check.py
    ai_rewrite_docx.py
  references/
    ai_rate_signals.md
    report_format.md
  assets/
    report_template.html
docs/
  assets/
    ai-check-report-preview.png
tests/
  test_ai_check.py

快速开始

在 AI 编程助手中发送：

使用 ai-check-skills 帮我为 XXXX（文档路径）生成 AI率检测报告

例如：

使用 ai-check-skills 帮我为 F:\papers\main.docx 生成 AI率检测报告

AI 助手会读取 DOCX，生成可解释的片段信号，并输出：

可选择文本的 PDF 报告
HTML 报告
summary JSON

如果需要继续降 AI 率，可以在报告生成后让 AI 助手先列出改写方案；用户确认后再写入新的 DOCX。原始 DOCX 不会被原地修改。

示例提示词

使用 ai-check-skills 帮我为 F:\papers\main.docx 生成 AI率检测报告
根据 AI-check 报告，先给我看需要修改的片段和改写方案，确认后再写出新的 Word。
只检测，不改 Word。

注意事项

报告仅供参考。
不要宣称结果等同于知网、维普、Turnitin 或其他闭源检测平台。
改写时应保留事实、术语、公式、数字、引用编号和结论方向。
如果原文缺少证据，不要编造实验、数据、案例或引用；应降低语气、补充边界，或使用已有上下文。

License

MIT

English

AI-check Skills is an open-source Codex/OpenCode-style skill for AI-rate report generation, automated AI-writing reduction, and academic repetition/AI-writing style cleanup. It generates a polished, selectable-text PDF/HTML report from a Word document, then applies confirmed revisions to a new DOCX only after user approval.

This project is a small part of EasyIdea Research Workbench. For a full research-writing workflow with a live DOCX workbench, report import, annotations, batch review, and one-click accept/reject, download EasyIdea: https://honeymeta.com/easyidea

Highlights

Reads .docx files and extracts body, abstract, and conclusion text.
Splits long academic text into reviewable chunks.
Extracts explainable AI-writing signals such as template phrases, dense connectors, generic claims, and uniform sentence rhythm.
Keeps mitigating evidence such as citations, metrics, method names, domain details, and quantitative results.
Lets the active AI assistant judge aigcValue, verdict, reason, and signals in the visible conversation.
Generates a polished AI-rate report as HTML and selectable-text PDF.
Applies user-confirmed replacements to a new DOCX without modifying the original document.
Supports Codex, Claude Code, OpenCode, and similar agent runtimes that can run local scripts.

Independent Pipeline

AI-check Skills does not require LibreOffice, soffice, Microsoft Word automation, DOCX-to-PDF rendering, or screenshot rendering.

DOCX parsing and rewriting: python-docx
PDF report generation: reportlab
Deterministic signal extraction: bundled Python scripts

The scripts do not call AI models and do not produce a final AI probability by themselves. The AI assistant remains responsible for judgment and rewriting so the user can see the reasoning.

Install

Ask your AI coding assistant to install this repository as a skill:

Install HoneyMeta/ai-check-skills

After installation, restart Claude Code / Codex / OpenCode, or the assistant runtime you use, so the new skill is loaded.

Quick Start

Send a prompt like:

Use ai-check-skills to generate an AI-rate report for C:\papers\main.docx.

For Chinese workflows, you can use:

使用 ai-check-skills 帮我为 XXXX（文档路径）生成 AI率检测报告

The assistant will scan the DOCX, produce an explainable PDF/HTML report, and only write a rewritten DOCX after you approve the replacement plan.

Safety Notes

The report is for reference only.
Do not claim that it is equivalent to CNKI, VIP, Turnitin, or another closed detector.
Preserve facts, terminology, formulas, numbers, citation markers, and conclusion direction during rewriting.
If the source lacks evidence, do not invent experiments, data, cases, or citations.