★ FEATURED ARTICLE 【免费下载链接】Waza Engineering habits you already know, turned into skills Claude can run.项目地址https://gitcode.com/gh_mirrors/cl/Waza点击查看免费下载这篇技术指南围绕 Waza 插件中write技能的mode-long-form.md长文模式展开讲清楚它在什么条件下被加载、为什么长文不能单遍重写、五步工作流如何落地以及它和中文长文专项规则、标点门禁Punctuation Gate如何配合。读完你会掌握一套可执行的长文编辑流程先只读映射结构、标记三类结构水分再逐节做行级去 AI 味最后用仓库自带脚本过一遍标点检查。长文模式是什么write 技能里的结构性工作分支Waza 的write技能默认做的是行级重写line-level rewrite处理改稿、润色、去 AI 味、技术说明改写这类请求。write 技能主页 里有一个 Mode Picker模式选择器只有请求命中了对应行才会加载对应的模式文件请求加载的模式Release note、changelog、更新流文案references/mode-release-notes.md公开 issue / PR 上的维护者回复references/mode-public-reply.md安装步骤、操作说明、错误文本、工具描述的措辞澄清references/write-technical.md配合语言参考有几个章节、表格或图片的长稿需要结构性工作references/mode-long-form.md中英对照或混排文本的漂移检查references/write-zh-bilingual.md跨地区产品 / 站点 / App 文案references/write-product-localization.md长文模式 的开头就划清了边界加载时机输入是一篇长稿long draft需要先做结构层面的工作之后才轮到行级编辑激活条件一篇长文章需要结构审查structural review明确的限制仅仅有多个标题或多张图片本身不授权重构。也就是说标题多、图片多只是长文的外观触发结构手术的必须是真实存在的结构问题。这个边界写进了 SKILL.md 的 Hard Rules 里默认情况下不得静默重构No silent restructuring除非用户明确要求重排标题、重排段落或合并章节唯一的例外就是长文模式因为结构本身就是主要问题但它仍然要求先提出变更点而不是静默执行。为什么长文不能单遍重写长文模式的末尾有一条硬性结论值得先讲清楚Do not single-pass rewrite a long article: it silently overwrites the authors hand-tuned phrasing and cannot be reviewed as a diff.单遍重写长文的两个代价一是会静默覆盖作者逐句调校过的措辞这些措辞往往带着作者的节奏、口语词和判断二是重写结果无法以 diff 的形式被审查读者只能看到全文都变了却不知道哪里为什么变。这与 write 技能主页 的核心立场一致过度编辑和编辑不到位一样糟Over-editing is failure, equal to under-editing。大多数润色是减法删重复、删总结腔、删复述结论而不是逐词替换。对长文来说这个原则进一步升级为先找结构问题再做行级处理且两类工作分开进行。对应的内容规则沉淀在中文参考 write-zh.md 的结构级重复与表格复读长文专项一节后面单独展开。五步工作流详解长文模式给出的工作流是五个步骤按顺序执行。第一步先映射只读动手编辑之前先把整篇文章通读一遍列出每一个##章节、每一张表格、每一个列表、每一张图片。然后标记三类结构问题跨章节重复cross-section repetition同一张检查清单、同一份判断清单、同一个核心论断出现在 2 个及以上章节里表格复读table re-reading某个章节的正文在逐行复述它上方那张表格的行整段冗余whole redundant sections or paragraphs整节或整段没有提供别处没有的信息。这一步的关键词是只读。先建立全貌不急着改任何东西。结构问题只有把整篇摊开横向比对才能发现单段 in-place 润色检测不到这正是长文模式存在的原因。第二步测试段落的贡献一个段落能承载内容的方式不止一种。经验、情感、个人信念、资历、解释都能成为保留一段的理由。缺少新事实或来源不是删段的理由。检查一次编辑时要看三样东西是否被保留事实意义factual meaning作者立场the authors stance情感强度emotional intensity。长文模式的原话是一篇更短、更中立的稿子可能是更差的稿子A shorter, more neutral draft can be a worse one。这对应 write 技能主页 里一篇文章有一个说话者A piece has a speaker的原则作者的口语词、节奏、知识和判断要保留作者的喜爱、沮丧、骄傲、感激、个人信念都是内容即使它们被表达得很抽象、甚至以结论的形式出现。删除段落之前先确认这段有没有在别处重复的技术事实、数据或逻辑没有才删不确定就改成提议。第三步尊重编辑范围编辑范围由用户请求决定不能自己扩大只读请求比如帮我看看结构给出建议的变更点proposed change-points不直接改明确的重写请求只在该范围内做编辑常规的句子删减不需要反复征求同意整段删除必须在 diff summary 里点名Name whole-paragraph cuts in the diff summary删除章节或重排标题必须先问除非这项结构工作本来就是请求的一部分。这条规则的用意是把结构改动变成可见、可审查的决策而不是藏在润色名义下的静默操作。第四步行级去 AI 味逐节进行结构问题处理完后进入行级阶段。做法是按节进行section by section使用对应的语言参考文件。语言参考的加载逻辑在 write 技能主页 的 Pre-flight 部分文本含中文字符 release notes / 社交发文 → 在write-zh.md之上再加载write-zh-release-notes.md中英双语或翻译审阅 → 加载write-zh-bilingual.md和两种语言的参考含中文字符的普通 prose → 加载 write-zh.md其他情况 → 加载 write-en.md。对镜像翻译mirrors指同一篇文章的中英版本要同时检查意思和母语节奏避免一种语言的惯用法被机械搬进另一种语言。第五步返回要求的产物产物形态取决于请求方式两种典型情况仓库编辑保留 frontmatter、代码、媒体、链接和实质性解释运行站点构建run the sites build并报告范围内的 diffscoped diff。这类编辑属于交付不能只用一句改好了带过。粘贴文本重写返回改写后的 prose 本身。无论哪种情况编辑过的 prose 都要跑一遍Punctuation Gate标点门禁。门禁只检查标点和中英混排问题不允许为了迎合风格规则去改动技术示例原文without changing technical examples to satisfy a style rule。三类结构水分长文专项的判定标准write-zh.md 的结构级重复与表格复读长文专项把结构问题细化为三类每一类都给了判断信号1. 跨章节同义清单同一张评估 / 判断 / 取舍清单在 2 个以上##节里各写一遍。比如评估机器人要看动作频率、数据来源、失败处理在入门、对比、总结三处都出现。处理方式留信息最全的一份其余删掉或后文用一句话带过。2. 表格旁正文复读一节里有对比表正文却一行行复述表里的列。正文只补表格给不了的东西里程碑、具体例子、判断、为什么。表格能讲清楚的交给表格。3. 图 / 表旁文字复述紧邻一张图或表的正文把图 / 表已经列出的项再用文字列一遍或者用这张图更直观这类预判句替图说话。删掉复述和预判只留判断和上下文。通用判定信号删掉这段 / 这句读者会不会丢失一个别处没有的事实不会就是复读删会就保留。一个明确的例外图后说明段落不能以重复为由删除。原因很实在图片的 alt text 读者看不到图后的文字说明才是读者真正读到的解释。图后说明段不属于收尾总结判断标准是如果删掉这段文字读者就看不懂这张图就必须保留。英文参考 write-en.md 在Re-anchoring after cutting recaps一节给了对应的英文长文规则裁剪复述时要保留具体的项目细节但不要在每一节结尾都回扣同一个项目回扣只有在它补充了新的后果或限制时才配存在。行级去 AI 味中文场景的执行顺序write-zh.md 开头就说得很清楚它是认 AI 味的例子库不是从头套到尾的检查清单。先用它识味再凭判断改自然的句子别动。中文场景的执行流程有明确先后顺序不能反着来先识别翻译腔、模板句和重复解释段末总结也要连着前文读作者的情绪、价值判断和写作缘由是内容不能因为抽象、抒情或像金句就删只修不自然的表达不把态度改淡再顺句子解决拗口、断句过碎、节奏太硬最后调标点减少不必要的括号、引号和短句句号连发术语只在必要处解释首次出现可注解后文不重复堆注释。最高优先级是自然 风格化不要为了像人说话硬塞口语词、情绪词、俚语、感叹词句子已经自然、清楚、稳就不要往里加其实 / 说白了 / 哈哈 / 谁能想到这类词。同时要保留作者已用的口语词作者原文已经在用很其实到底不要替换成正式词。长文场景下AI 味检测里有几条高频模式特别值得留意收尾拔高和替读者下结论一段刚把事情讲完末尾再补一句拔高、总结、说教或展望。识别信号是到这里这说明这本身就是也就是说可以看出这类开头或者段末一句比其他句短且抽象翻案腔先给读者立一个他并没有的误解再推翻它给下文抬价。改法是找到这句话原本想下的判断从正面说出来依据放在旁边重复同一个意思说了不止一遍跨节重复、段内重复、同义词循环都属于翻译腔五套路思考过程用物理动作动词接住、击穿、锋利、形容词抢先下判断更干净逻辑很清晰、抽象名词做主语X 的 Y 比 Z 更 W、英文术语和中文混用context、state、cache 换成上下文、状态、缓存、长定语堆在名词前面一句话里出现三个以上的的就要警惕。长文模式的末尾正是把编辑导向这份清单处理完结构问题后逐节进行行级去 AI 味使用相关语言参考对镜像版本要同时检查意思和母语节奏。单遍重写之所以被禁止是因为它把这些需要判断的取舍全部压平了。Punctuation Gate标点门禁如何落地标点门禁是长文模式第五步的收尾动作由 write 技能的两个脚本实现check-punctuation.sh 是入口它转调同目录下的 Python 实现 check_punctuation.py。write 技能主页 给出的是跨安装布局的调用方式脚本可能在skill-base-dir/scripts/直接安装 / 插件安装也可能在skill-base-dir/skills/write/scripts/内联根目录的 release ZIP用一段循环在两种布局里找到它再执行GATE for candidate in \ skill-base-dir/scripts/check-punctuation.sh \ skill-base-dir/skills/write/scripts/check-punctuation.sh; do [ -f $candidate ] GATE$candidate break done [ -f ${GATE:-} ] || { echo punctuation gate not found under the installed skill base; reinstall Waza 2; exit 1; } bash $GATE --lang zh|en|ja|auto file # or pipe text via stdin从 check_punctuation.py 的源码可以看到它的具体规则按语言检查--lang可选zh | en | ja | auto默认auto。auto 按固定优先级分类整段输入出现任何假名kana判为 ja否则出现任何汉字判为 zh否则出现韩文判为 ko保留、暂无规则、跳过否则判为 en。混合语言或以英文为主的文本要显式传--lang检查内容CJK 句子里的半宽标点包括跨 markdown 强调标记所以**标签**:也能被逮到、紧贴下一个拉丁字母的逗号 / 分号、贴着汉字的半宽括号、CJK 与 Latin 之间缺失或错误的中西文空格、em/en 破折号中文和英文输出都禁跳过范围跳过围栏代码块、行内代码、URL 和链接目标所以属于代码的标点永远不会被误报两种模式默认模式打印发现并 exit 1有发现时全部干净打印punctuation: ok并 exit 0--fix模式把修正后的文本打印到 stdout只做零歧义的修正且只对 zh 生效退出码语义exit 1 有需要修的发现exit 2 文件不可读这样路径问题与检查失败可以区分。对照 write-zh.md逐字符标点全角 / 半角、破折号、中西空格由门禁脚本检测参考文件只保留什么时候该破例、引号何时该用这类判断。也就是说门禁管字符级事实参考文件管判断级取舍两者分工明确。长文模式在 Waza 里的位置从 Waza 技能解析器 的路由表看写作类请求统一进write技能长文模式是它按 Mode Picker 分流出的一个分支。配套的约束还包括durable-context.md跨技能共享的前置说明。/write场景下提供的文本和当前发布状态优先于记忆持久偏好可以设定简洁度、语气、社交文案形态但不能覆盖就地编辑、保持意思不变的硬规则mode-release-notes.mdrelease notes 是另一个分支它和长文模式同属一个技能、互相独立。长文模式强调结构先行的原因在 write-zh-release-notes.md 里也能看到呼应条目数取覆盖本次构件所需的最小值不拿内部实现凑数waza-routing.md路由表把write定位为草稿 / 重写 / 校对 / 去 AI 味 / 推文 / launch 文案 / 文档审阅长文模式属于其中的文档与长稿处理路径。实践要点小结把长文模式完整落地关键动作可以归纳为五条先读全篇再动手列出所有##、表格、列表、图片标记跨章节重复、表格复读、整段冗余三类问题删前测贡献事实、经验、情感、立场、解释都能撑起一段没有新事实不是删的理由丢了作者立场才是编辑范围分两层只读请求给变更点重写请求在范围内直接做整段删除要点名删节 / 重排标题先问结构先行行级随后结构手术按 write-zh.md 的长文专项判定行级去 AI 味逐节进行、配对应语言参考收尾跑门禁编辑过的 prose 用check-punctuation.sh --lang zh|en|ja|auto过一遍技术示例保持原样不让风格规则改动代码和命令。这套流程的价值在于把长文编辑从一次性的全文重写拆成可审查的两阶段结构问题先被点名、被决策行级问题再被逐节处理最后所有改动落在 diff 里作者可以逐条否决。仓库里 SKILL.md、mode-long-form.md、write-zh.md、check_punctuation.py 四份文件构成了从判断规则到脚本约束的完整闭环值得对照阅读。赞分享【免费下载链接】Waza Engineering habits you already know, turned into skills Claude can run.项目地址https://gitcode.com/gh_mirrors/cl/Waza点击查看免费下载相关推荐Waza 长文模式先做结构手术、再逐段去 AI 味的长文改稿工作流Waza 长文模式先做结构手术、再逐段去 AI 味的长文改稿工作流 Waza 的 write 技能默认按行级改写处理输入文本但当输入是一篇需要动结构的几千字Waza write 技能全解把「去 AI 味」做成可执行、可验证的工程规范Waza write 技能全解把「去 AI 味」做成可执行、可验证的工程规范 本篇围绕 Waza 仓库中 write 技能定义文件 https://link.Waza /write 技能英文去 AI 味指南识别并消除可预测的 AI 写作模式Waza /write 技能英文去 AI 味指南识别并消除可预测的 AI 写作模式 导读 Waza 是一个把工程师已有习惯封装成可运行技能的仓库其中 /wr上一篇ncmdumpGUI终极指南3分钟解锁网易云音乐NCM格式实现音乐自由播放下一篇XML Notepad终极指南微软官方免费XML编辑器完全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
