Index of every page on this site: llms.txt
All skills
steelan9199 avatar

/paragraph-reorder-yashu

@9e01957
Run it yourself

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

  • 1 file
  • 6.1 KB
  • Updated 4 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/steelan9199/wechat-publisher/paragraph-reorder-yashu

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈66 tokens for metadata: the name and description. ≈1.5k when used: this file.

Description uses 1.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈111 characters, or 1.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

段落顺序重排

功能概述

本技能通过主题聚类策略重排文章段落顺序。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 报错 检查磁盘空间和路径权限,提示用户处理后重试

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 9e01957. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 4 months ago
metadata
{
  "author": "牙叔教程",
  "updated": "2026-07-14 14:10:00",
  "version": "1.0.0"
}

README badge

README badge for steelan9199/wechat-publisher/paragraph-reorder-yashu