关于 unslop
Unslop 是用于编辑说明性文字和演示文案的技能。它在保留原意、语气、技术准确性和受保护内容的同时,让表达更清楚自然。
主要功能
- 01理清说明性文字
- 02编辑演示文案
- 03遵循提供的编辑偏好
- 04保留受保护的结构化内容
- 05检查清晰度与表达风格
适用场景
- 01修改难读的说明文字
- 02调整演示内容以符合用途
- 03编辑文字时保留技术术语
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ken-guru/ skills --skill unslop安装后在 Claude Code 中输入/unslop确认已加载。
附带文件evals/unslop.jsonfixtures/unslop-fixtures.md
详细介绍
去除冗余表达
编辑说明性文字或展示文案,使其清晰自然。 保留作者的原意、要求的语气、技术精确性及任何内容约定。
流程
- 确定输出边界。区分对话文字、展示内容、引文、引用来源、无障碍文本和受保护的结构化内容。
- 编辑前,先了解用户或项目提供的编辑偏好。
- 根据以下通用清晰度规则,检查可编辑文字。
- 只改写需要调整的内容。保持预期的语气和受众定位。
- 将明确的偏好视为要求,而非建议。若未提供偏好,就选择最适合当前媒介且最清晰的表达方式,不要擅自设定统一风格。
- 执行保护性检查,并进行最终的自然表达审核。
通用清晰度规则
- 用具体事实或效果替换浮夸表达。
- 删除填充语、聊天机器人套话、谄媚的开场白和泛泛的结论。
- 用明确的来源替换模糊的归因,或删除相关说法。
- 在同样精确的情况下,优先使用朴素的词语。
- 行为主体明确时,优先使用主动语态。
- 将晦涩冗长的句子缩短或拆分,避免读者反复回读。
- 自然调整节奏。不要刻意追求随意感、虚假的个性或不必要的第一人称表达。
- 在可以使用具体词语时,替换隐喻性、宣传性或流行的行话。
- 当公认的技术术语指代读者需要了解的真实概念时,应予以保留。
- 逐句检查:这句话是否提供了事实、指示、示例、决策或有用的限定条件?如果没有,就删除或改写。
上下文风格偏好
将这些视为可配置选项。对于可编辑文字,用户明确提出的偏好优先于这些默认项:
- 长破折号、冒号、括号及其他标点
- 标题使用句首字母大写还是标题式大小写
- 粗体、列表和三项并列结构
- 第一人称、观点和对话式回应
- 格式或语气需要时使用简短的不完整句
将 avoid 偏好视为检查要求:如果内容未受保护,就移除对应表达模式,包括保留相同风格效果的同类表达。将 prefer 偏好视为积极目标,并在格式允许的情况下始终如一地采用。不要让偏好损害原意、无障碍性、技术精确性或输出约定。
对于展示类项目,偏好示例包括:
avoid:“粗体引导语后接冒号”“长破折号”“泛泛的项目符号列表”prefer:“简短的陈述句”“不编号的陈述”“朴素的标题”tone:“温暖直接”“正式克制”或用户提供的其他描述
受保护的内容
不要仅为追求风格而改写以下内容:
- 代码、命令、架构定义、JSON、YAML 和机器可读报告
- 项目术语表中的规范术语
- 引文和引用来源
- 无障碍文本,除非改动能使其更清晰或更具体
- 用户为格式或传输提供的文字
- 刻意采用的正式、活泼、简短、文学化或其他特定语气
如果可编辑文字围绕着受保护内容,请在不改变受保护内容约定的前提下,改进周围的文字。
展示内容
展示内容遵循相同的清晰度规则,但限制更严格。 保持幻灯片文案简洁,保留叙述层次和内容容量,不要为了让语气更口语化而牺牲无障碍性或语义。将项目明确的编辑偏好应用于幻灯片文案和演讲者备注。优秀的幻灯片句子应足够具体,即使演讲者不作解释,也能传达信息。
最终审查
返回结果前,请自问:
- 哪些地方听起来像机器生成的?
- 我是否消除了这种痕迹,同时保留了有用的限定条件?
- 我是否保留了原意、语气、技术术语、无障碍性和结构?
- 读者能否根据每项保留的表述采取行动或学到具体内容?
不要承诺结果无法被检测出是由 AI 生成的。如果用户要求审查,请简要说明所做的修改,不要添加聊天机器人式的结束语。
评论
支持 Markdown