steelan9199 段落顺序重排
功能概述
本技能通过主题聚类策略重排文章段落顺序。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. 等） | 连续的列表项（无空行分隔）视为一个段落单元 | 列表项之间无空行时属于同一逻辑块，拆分会破坏列表结构 |
聚类排序策略
聚类排序是本技能的核心，遵循以下原则：
- 主题识别：AI 为每个段落提炼一个 2-5 字的主题标签（如"性能优化""背景介绍""方案对比"）。
- 聚类归组：将主题相同或语义相关的段落归入同一组。例如"性能优化"和"加载速度"归为一组。
- 组内稳定排序：同一聚类组内，段落保持原始相对顺序不变，不额外翻转。
- 组间排序：聚类组之间，按该组中最早出现的段落的原始位置排序。这样能最大限度保留原文的整体走向。
- 最小扰动原则：如果两种排列方案的主题连贯度相近，选择对原文改动最小的方案。
输出格式
段落映射对照表（步骤 7 输出）
| 原位置 | 新位置 | 主题标签 | 段落预览（前 20 字） |
|--------|--------|---------|---------------------|
| 1 | 1 | 引言 | 本文将介绍... |
| 5 | 2 | 引言 | 在实际应用中... |
| 2 | 3 | 性能 | 性能优化是... |
| 4 | 4 | 性能 | 通过缓存机制... |
| 3 | 5 | 总结 | 综上所述... |
结果摘要（步骤 10 输出）
## 重排完成
- 备份文件：{备份文件路径}
- 已更新：{原文件路径}
- 调整段落数：{N} 段（共 {M} 段中有 {N} 段位置发生变化）
错误处理
| 错误场景 | 错误表现 | 处理方式 |
|---|---|---|
| 文件不存在 | Read 报错文件不存在 |
检查路径是否正确，提示用户确认文件路径 |
| 文件为空 | 读取后内容为空 | 输出"文件内容为空，无需调整"并结束执行 |
| 无段落结构 | 整篇文章只有一个段落块（无空行分隔） | 输出"文章只有一个段落，无需调整"并结束执行 |
| 写入失败 | Write 返回错误 |
检查文件是否被其他程序占用，提示用户关闭后重试 |
| 备份失败 | Copy-Item 报错 |
检查磁盘空间和路径权限，提示用户处理后重试 |