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 报错 | 检查磁盘空间和路径权限，提示用户处理后重试 |