Community写作与编辑github.com

散文编辑

假定**事实正确**。专注于文字和形式,而非事实。同目录下的 `NOTES.md` 包含工作示例。

散文编辑 是什么?

该技能专为对已有文本进行风格和结构编辑而设计,前提是内容在事实上是正确的。它的核心目标是提升文本的清晰度、简洁性和可读性,同时避免改变其真实含义。技能定义了严格的规则,用于删除冗余、程式化的内容以及 AI 生成的痕迹,确保每一句话都为读者提供价值——要么说明该做什么、该期待什么,要么说明出错的后果。支持假设用户具备领域知识的环境(如开发者工具或 AI Agent 平台),技能通过强制执行高效的层级结构和程序模板来优化文档。其方法包括删除“清嗓”式的开场白、重复陈述、填充性过渡词以及不必要的格式化。此外,它还提倡为所有操作提供“为什么”的解释,并针对不同上下文(如每会话加载、按需使用)界定了成本意识下的规则编写方式。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/productivelyslacking/agent-skills/tree/HEAD/skills/prose-editing

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

散文编辑 是做什么的?

假定事实正确。专注于文字和形式,而非事实。同目录下的 NOTES.md 包含工作示例。

检验标准

每一句话都告诉读者该做什么、该期待什么,或者做错了会发生什么;删掉那些一个都不符合的句子。简洁不等于简短:切勿为了凑字数而删减实质内容,应当砍掉的是包裹实质的冗余部分。

删除

  • “清嗓”式开场。 将实质内容放在第一句。
  • 重复陈述。 只说一次,并且摆在最合适的位置。
  • 填充性过渡词(如“值得指出的是”、“如上所述”、“为了”)。
  • 不改变行为的评述(如“平淡但重要”)。
  • 含糊的量化(如“出人意料的比例”)。给出它起作用的真实原因,否则删掉断言。
  • 回避承诺的含糊其辞。 以决策标准为依据,如实陈述真实的不确定性。
  • 用于强调的引用块。 保留那些确实会改变读者行为的警告。

删除被标记为“AI 生成”的痕迹

模型会选择最宽泛读者群体的内容;而作者则只为一位读者和一个主题服务。首先审视结构,因为用词习惯会随模型变化。只有当一句话能给予当前读者他们尚未拥有的信息时才保留。

  • 铺垫而非直述。 例如“不是 X 而是 Y”,但根本没人提过 X;用一句话重复观点的结尾;在观点之前添加冗长铺垫;听起来深刻却毫无实质的格言。直述事实。
  • 按套路堆砌节奏。 无处不在的三连排比和破折号、重复的句式开头、堆叠的限定词。只有确实有三个并列项时才用三个。
  • 过度吹捧。 把普通事实称为“关键”或“强健”,使用推销语言、无名的“权威”、用“-ing”形式暗示意义。直接说明它的作用,否则删掉。
  • 按套路格式化。 每一条都加粗、每个想法都设标题,而其中的强调或结构毫无意义。
  • 草稿遗留。 聊天框、知识限制声明、与第一句话重复的标题、谈论文档本身而非其主题的文字。
  • 错位的读者。 向已经知道的读者重复解释,导致决策信息出现在最后。

保留作者原本的意思,不要添加任何东西来替代你删除的内容。真正的对比、真正的三条并列、或引用来源可以保留;而那些只是为了“显示”却没有增加任何价值的痕迹则要删除。

受保护:为什么绝非无意义

保留解释为什么(如为什么用这个顺序、这个工具、先做这个检查、这个步骤不能跳过)的句子,即使它不发出任何指令:这个理由能让读者处理文档未预见的情况,并判断流程何时不再适用。在理由不明显的地方给出理由,尤其对于安全与合规规则,因为意图才是让读者在无规则覆盖时能应用规则的关键。当一个句子同时包含修饰和理由时,重写句子以保留理由。检验标准是:没有这句话,读者是否会做得更差。

删除不必要的结构

只有在工作确实需要时才增加层级、表格、矩阵、嵌套标题或分支,而不是因为它们看起来严谨。试问:工作流是否真的在此处分叉(如果每位读者都走相同路径,那就是一个列表)?这一步是否必要,还是仅仅看起来周全?如果流程只有四步,就写四个步骤:首次阅读能执行的四个步骤流程,胜过容易被跳过的九个正确步骤。保留常见的陷阱、顺序陷阱以及“为什么”。

模型加载的指令

规则表、技能、角色文件和提示词每次加载时都会消耗 token,而读者是需要规则而非其背后故事的模型。根据加载时机来衡量其代价(D28):

  • 每次会话(规则表、技能和角色描述):只有规则。描述用不超过 300 个字符说明技能涵盖什么及何时加载;tools/check.py 强制执行这些预算。
  • 按需使用(技能或角色正文):规则加一句理由。只有在规则看起来可选时才添加一个具体的失败案例,不包含日期、计数或项目名称。
  • 按需调阅(NOTES.md、EVIDENCE*.md):包含事件、数字、日期和来源。正文则指向这些文件。

使用祈使语气。不要复述其他已加载文件中已有的规则;按名称引用它们。docs/REQUIREMENTS.tsv 中的固定需求会随其重写而移动,绝不会静默消失。

流程的结构

目的 → 何时使用 → 开始前准备 → 步骤 → 验证 → 如果不奏效 → 上报

  • 切勿省略“验证”:这是最常被跳过也最有价值的部分。
  • 每个步骤只做一个操作。精确命名 UI 元素。给出完整路径。
  • 在不可逆的步骤之前标明警告,而不是之后。
  • 面向有能力的陌生人写作:懂领域,但从未见过此环境。
  • 标题应反映读者会搜索的内容。不要包含日期、版本号或“v2”。

语气

  • 使用平实的语言和短句。
  • 不要用“代价”来软化约束(如没收、终止、数据丢失、个人责任):直接、明确地说明。
  • 链接厂商文档而非复制其内容;仅记录你工作方式特有的部分:复制的文档到达时已经过时。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能