debloat

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Cut a bloated artifact to its load-bearing minimum: same meaning, fewer words.
将臃肿的文档精简至核心内容最小化:含义不变,字数更少。

Goal

目标

An artifact that is correct and current can still rot a second way: it accretes. Each edit bolts a qualifier onto the nearest sentence, a rule gets restated wherever it might apply, an enumeration grows into a wall — until a reader must study what they should skim.
debloat
compresses that bloat to its load-bearing density: every claim that carries weight survives, every word that does not is cut. It is not a rewrite (
re0
), a dedup (
ssotize
), or a tell-remover (
dedash
,
detool
) — it is a density pass on prose that is otherwise fine.
内容准确的文档仍可能出现另一种“变质”:冗余堆积。每次编辑都会在就近句子添加修饰语,规则在所有适用处重复表述,枚举内容演变为堆砌的长列表——直到读者不得不仔细阅读本该快速浏览的内容。
debloat
可将这类冗余压缩至核心密度:所有重要信息得以保留,无意义的冗余内容全部删除。它既不是重写工具(
re0
)、去重工具(
ssotize
),也不是冗余表述移除工具(
dedash
detool
)——它仅对原本质量良好的文本进行一次精简处理。

Workflow

工作流程

  1. Pin the artifact and read it end to end; note in one line what each section must convey — the load-bearing content that has to survive.
  2. Find the bloat, not the content: padding that adds length but not meaning; a qualifier or parenthetical the sentence holds without; a fused sentence carrying three ideas; a wall of enumeration where a rule plus a short list would do; a point restated within reach of itself; litigation-history (why-we-decided-it) where the rule alone suffices.
  3. Compress in place: cut the padding, split the fused sentence or drop its dead clause, collapse the wall, keep a repeated point once. Move nothing to another artifact and re-derive nothing.
  4. Preserve every load-bearing claim — a rule, fact, constraint, or example that carries weight. If cutting a word would lose one, keep the word.
  5. When the bloat is really duplication across artifacts, or the content has drifted stale, stop and name it: hand duplication to
    ssotize
    and drift to
    re0
    .
    debloat
    only tightens.
  6. Re-read cold and cut again — the first pass always leaves some.
  1. 锁定目标文档并通读全文;用一句话记录每个章节必须传达的核心内容——即必须保留的重要信息。
  2. 识别冗余而非内容:增加长度但无实际意义的冗余修饰;句子可无需保留的限定语或插入语;包含三个独立观点的冗长复合句;可替换为“规则+简短列表”的枚举堆砌;邻近位置的重复表述;仅需保留规则即可、无需说明决策背景的内容。
  3. 原地精简:删除冗余修饰,拆分冗长复合句或移除无效从句,合并枚举堆砌,重复内容仅保留一次。不将内容转移至其他文档,也不重新生成任何内容。
  4. 保留所有重要信息——包括规则、事实、约束条件或重要示例。若删除某个词汇会导致信息丢失,则保留该词汇。
  5. 若冗余实为跨文档重复,或内容已过时,请停止操作并选用对应工具:跨文档重复使用
    ssotize
    处理,内容过时使用
    re0
    处理。
    debloat
    仅负责精简文本。
  6. 时隔一段时间后重新阅读并再次精简——第一次处理总会残留部分冗余。

Rules

规则

  • Cut words, never load-bearing claims. Every rule, fact, and constraint that was there is still there; only the density changed.
  • Preserve the artifact's voice and structure; compress within it, do not re-style it.
  • Not a rewrite, a dedup, or a tell-remover: re-derive nothing (
    re0
    ), move nothing to another home (
    ssotize
    ), and leave em-dashes and stack nouns to
    dedash
    /
    detool
    .
  • Respect intended richness: human-facing prose meant to teach or orient (a quickstart, a worked example) earns its length — compress the bloat, not the accessibility.
  • A pass that finds nothing genuinely bloated changes nothing.
  • Mutate with edit-safety: assert each target exists (report a MISS, never a silent no-op), edit unicode-safe (
    PYTHONUTF8=1
    ), replace per occurrence, and script a large structural move.
  • 删除冗余词汇,绝不删除重要信息。所有原有的规则、事实和约束条件必须全部保留;仅调整文本密度。
  • 保留文档的语气和结构;仅在原有框架内精简,不重新调整风格。
  • 并非重写、去重或冗余表述移除工具:不重新生成内容(
    re0
    的功能),不将内容转移至其他文档(
    ssotize
    的功能),保留破折号和堆叠名词(由
    dedash
    /
    detool
    处理)。
  • 尊重文本的丰富性需求:用于教学或引导的面向用户的文本(如快速入门指南、实例教程)需要足够长度——仅精简冗余,不破坏可读性。
  • 若未发现真正的冗余内容,则不做任何修改。
  • 安全编辑:确保每个目标内容存在(报告缺失,绝不静默无操作),支持Unicode安全编辑(
    PYTHONUTF8=1
    ),逐处替换,对大型结构调整编写脚本。

Verification

验证

Before finishing:
  1. Every load-bearing claim present before is present after — only words were cut.
  2. The result reads tighter to a cold reader, and reads as intended-terse, not amputated.
  3. Anything that was duplication or drift, not bloat, was handed to
    ssotize
    /
    re0
    , not force-compressed.
完成前需确认:
  1. 所有原有的重要信息均保留——仅删除了冗余词汇。
  2. 结果文本对初次阅读者而言更精简,且是有意为之的简洁,而非生硬删减。
  3. 所有属于重复或过时的内容(而非冗余)已交由
    ssotize
    /
    re0
    处理,而非强制压缩。