text-truncator

name	text-truncator
description	智能截断文本，保持内容的完整性和语义连贯性。适用于长文本预处理、确保文本不超过指定长度限制
category	tools
version	2.1.0
last_updated	"2026-01-11T00:00:00.000Z"
license	MIT
compatibility	Claude Code 1.0+
maintainer	宫凡
allowed-tools	[]
model	opus
changelog	[{"version":"2.1.0","date":"2026-01-11T00:00:00.000Z","changes":[{"type":"improved","content":"优化 description 字段，使其更精简并符合命令式语言规范"},{"type":"changed","content":"模型更改为 opus"},{"type":"improved","content":"优化功能、核心能力、输入要求、输出格式的描述，使其更符合命令式语言规范"},{"type":"added","content":"添加使用场景、约束条件、示例和详细文档部分"}]},{"version":"2.0.0","date":"2026-01-11T00:00:00.000Z","changes":[{"type":"breaking","content":"按照 Agent Skills 官方规范重构"},{"type":"improved","content":"优化 description，使用命令式语言，精简主内容"},{"type":"added","content":"添加 license、compatibility 可选字段"}]},{"version":"1.0.0","date":"2026-01-10T00:00:00.000Z","changes":[{"type":"added","content":"初始版本"}]}]

文本截断工具

功能

智能截断文本，在保持内容完整性和语义连贯性的前提下，将文本截断至指定长度。

使用场景

• 对超出长度限制的文本进行预处理，使其符合智能体的输入要求。
• 在展示文本预览或生成摘要时，截取关键部分以提高效率和可读性。
• 辅助内容创作，对生成的长文本进行智能裁剪，避免冗余。

核心能力

• 语义优先截断: 优先在自然语义边界（如句号、问号、感叹号）处进行截断，最大限度地保持句子的完整性。
• 段落完整性: 在语义边界不足时，优先考虑在段落末尾或换行符处截断，避免破坏段落结构。
• 精确长度控制: 严格遵守用户指定的最大长度限制，确保输出文本不会超限。
• 截断标记插入（可选）: 可以在截断文本的末尾自动添加自定义截断标记（如"..."），以指示内容有删节。

输入要求

• 文本内容: 待截断的原始文本（字符串）。
• 最大长度限制: 文本截断后的最大长度（整数，如字符数或 token 数）。
• 截断标记（可选）: 自定义截断标记，如 "..." 或 "[内容已截断]"。

输出格式

【文本截断报告】

- 原始文本长度: [整数] 字/Token
- 截断后长度: [整数] 字/Token
- 截断位置: [位置描述，如 "在第X句末尾"] 或 "未截断"

### 截断后的文本
[截断后的文本内容]

约束条件

• 截断后的文本长度必须严格符合最大长度限制。
• 确保截断后的文本在语义上尽可能连贯和完整。
• 如果文本未达到最大长度，则不进行截断，返回原始文本。
• 输出格式必须结构化，清晰展示截断前后的长度信息和截断后的文本内容。

示例

参见 {baseDir}/references/examples.md 目录获取更多详细示例:

• examples.md - 包含不同长度、不同截断标记和复杂文本结构的截断示例。

详细文档

参见 {baseDir}/references/examples.md 获取关于文本截断工具的详细指导与案例。

---

版本历史

版本	日期	变更
2.1.0	2026-01-11	优化 description 字段，使其更精简并符合命令式语言规范；模型更改为 opus；优化功能、核心能力、输入要求、输出格式的描述，使其更符合命令式语言规范；添加使用场景、约束条件、示例和详细文档部分。
2.0.0	2026-01-11	按官方规范重构
1.0.0	2026-01-10	初始版本