# Paragraph Reorder Yashu

> 主题聚类重排文章段落顺序，将语义相近的段落归组消除话题跳跃。激活条件：用户消息须包含以下关键词之一:`调整段落顺序`、`段落重排`、`重排文章段落`、`段落顺序不合适`。

- Skill: `steelan9199/paragraph-reorder-yashu` (Agent Skill)
- Install (CLI): `npx skillmds add steelan9199/paragraph-reorder-yashu`
- Raw SKILL.md: https://api.skillmd.com/api/skills/steelan9199/paragraph-reorder-yashu/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: steelan9199 (https://skillmd.com/u/steelan9199)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/steelan9199/paragraph-reorder-yashu

---


# 段落顺序重排

## 功能概述

本技能通过主题聚类策略重排文章段落顺序。AI 语义分析每个段落的核心主题，将语义相近的段落归组放在一起，消除"话题跳跃"现象，使文章读起来更连贯。调整后直接覆盖原文件，同时生成备份。

**适用场景**：信息密度高、段落较多、话题分散的长文（观点类、技术类、资讯类文章）。

**不适用场景**：叙事类（按时间线展开）、流程类（按步骤展开）等段落顺序有内在逻辑约束的文章。

## 环境说明

- 本技能无脚本依赖，由 AI 自身语义理解能力驱动，无需安装任何依赖。
- 运行命令时统一使用 **PowerShell 5** 语法。
- `$SKILL_DIR` 指代本技能所在目录，即 `SKILL.md` 文件所在的文件夹。
- 本技能操作用户指定的 Markdown 文件（读取、备份、覆盖写入）。

## 执行步骤

| 步骤 | 执行动作 | 具体操作 |
|------|---------|---------|
| 1 | 获取文件路径 | 从用户消息中提取文章文件路径。若用户未指定路径，询问用户提供文章文件路径。 |
| 2 | 读取文章 | 运行 `Read` 工具读取用户指定的 Markdown 文件全文。 |
| 3 | 段落切分 | 将文章内容按空行（双换行）切分为段落块。代码块（```...```）即使内部含空行也视为单个段落单元。为每个段落记录原始位置索引（从 1 开始）。详细切分规则见【段落切分规则】。 |
| 4 | 段落数量检查 | 统计段落数量。若 ≤3 段 -> 输出"文章段落数量过少（N 段），无需调整"并结束执行。 |
| 5 | 语义分析与主题聚类 | AI 逐段分析核心主题，将主题相关/相近的段落归入同一聚类组。聚类组内保持原始相对顺序（稳定排序）。聚类组之间按该组首个段落原始出现顺序排列，最小化对原文结构的扰动。详细策略见【聚类排序策略】。 |
| 6 | 顺序评估 | 比较新顺序与原始顺序。若完全一致 -> 输出"当前段落顺序已合理，无需调整"并结束执行。若不一致 -> 继续下一步。 |
| 7 | 展示对照表 | 输出段落映射对照表，格式见【输出格式】。此步骤仅为信息展示，不暂停等待用户确认。 |
| 8 | 创建备份 | 运行 `Copy-Item "{原文件路径}" "{原文件目录}\{原文件名去扩展}_backup_{yyyyMMdd_HHmmss}.{扩展名}"` 创建备份文件。 |
| 9 | 写入重排结果 | 使用 `Write` 工具将重排后的完整内容写入原文件路径。禁止使用 `Set-Content`、`Out-File` 等 PowerShell 写入命令，避免 BOM 编码问题。重排内容 = 按新顺序拼接段落，段落之间用双换行（空行）分隔。 |
| 10 | 输出结果摘要 | 输出备份文件路径、已更新原文件路径、调整段落数量，格式见【输出格式】。 |

### 段落切分规则

段落切分是重排的基础，切分错误会导致文章结构损坏。遵循以下规则：

| 场景 | 处理方式 | 原因 |
|------|---------|------|
| 普通文本块 | 按空行分隔，每个连续非空行块为一个段落 | Markdown 标准段落定义 |
| 代码块（```...```） | 整体视为一个段落单元，不因内部空行拆分 | 代码块内部空行是代码结构的一部分，拆分会破坏代码完整性 |
| 标题行（#、## 等） | AI 语义判断：若标题与紧随其后的段落构成同一主题单元，则合并为一个段落；否则标题独立为一段 | 标题通常是其后续内容的概括，拆开可能导致标题与内容分离 |
| 列表块（-、1. 等） | 连续的列表项（无空行分隔）视为一个段落单元 | 列表项之间无空行时属于同一逻辑块，拆分会破坏列表结构 |

### 聚类排序策略

聚类排序是本技能的核心，遵循以下原则：

1. **主题识别**：AI 为每个段落提炼一个 2-5 字的主题标签（如"性能优化""背景介绍""方案对比"）。
2. **聚类归组**：将主题相同或语义相关的段落归入同一组。例如"性能优化"和"加载速度"归为一组。
3. **组内稳定排序**：同一聚类组内，段落保持原始相对顺序不变，不额外翻转。
4. **组间排序**：聚类组之间，按该组中最早出现的段落的原始位置排序。这样能最大限度保留原文的整体走向。
5. **最小扰动原则**：如果两种排列方案的主题连贯度相近，选择对原文改动最小的方案。

## 输出格式

### 段落映射对照表（步骤 7 输出）

```
| 原位置 | 新位置 | 主题标签 | 段落预览（前 20 字） |
|--------|--------|---------|---------------------|
| 1      | 1      | 引言     | 本文将介绍...         |
| 5      | 2      | 引言     | 在实际应用中...       |
| 2      | 3      | 性能     | 性能优化是...         |
| 4      | 4      | 性能     | 通过缓存机制...       |
| 3      | 5      | 总结     | 综上所述...           |
```

### 结果摘要（步骤 10 输出）

```
## 重排完成

- 备份文件：{备份文件路径}
- 已更新：{原文件路径}
- 调整段落数：{N} 段（共 {M} 段中有 {N} 段位置发生变化）
```

## 错误处理

| 错误场景 | 错误表现 | 处理方式 |
|---------|---------|---------|
| 文件不存在 | `Read` 报错文件不存在 | 检查路径是否正确，提示用户确认文件路径 |
| 文件为空 | 读取后内容为空 | 输出"文件内容为空，无需调整"并结束执行 |
| 无段落结构 | 整篇文章只有一个段落块（无空行分隔） | 输出"文章只有一个段落，无需调整"并结束执行 |
| 写入失败 | `Write` 返回错误 | 检查文件是否被其他程序占用，提示用户关闭后重试 |
| 备份失败 | `Copy-Item` 报错 | 检查磁盘空间和路径权限，提示用户处理后重试 |