| name | zu-article-polisher-skill |
| description | 中文技术观点长文去 AI 味与发布稿整理。针对中文文章、讲稿等，识别模板开场、假问题、句尾强行升华、宣传腔、模糊归因、三段式、否定式排比、过度平衡、白皮书腔、协作痕迹等；先保留作者真实观点和技术边界，再重写 AI 骨架、同步大纲、运行辅助脚本。 |
zu-article-polisher-skill
定位
这个 skill 用来处理用户的中文技术观点长文，目标是把 AI 生成文本常见的模板骨架拆掉，让文章更像一个有工程经验的人写出来。
核心约束：先保留观点和技术边界，再去 AI 味，最后才整理结构。 识别问题时既看通用 AI 写作痕迹，也看用户人工标记过的高频 AI 句式。
这不是通用润色器，也不是 AI 检测器。不要为了“更自然”凭空添加年份、数字、案例、来源、用户反馈、项目经历或更激进的观点。缺事实就把表达改朴素，或明确指出需要来源。
{baseDir} 表示本 SKILL.md 所在目录。
工作流
- 先读目标 Markdown 或用户贴出的完整文本，不要凭记忆改稿。
- 如果用户给了文件路径，先运行
python3 {baseDir}/scripts/check_article_style.py <markdown-file>。
- 脚本只用于定位疑似段落和固定结构问题。
- 脚本输出不是判决，不自动改写；最终是否重写由模型结合上下文判断。
- 用一句话写出文章真实主张。如果主张不存在或互相冲突，先说明，不要代替作者发明主张。
- 标记 AI 骨架段落：模板开场、假问题、整齐转折、三段式、句尾升华、白皮书总结、模糊归因、过度平衡。
- 需要详细模式或示例时，读取
references/style-guide.md，按里面的中文 AI 写作痕迹模式库逐类检查。
- 重写时围绕真实主张重建段落。保留事实、技术 caveat、观点归属；不要保留原来的句序、转折词和模板节奏。
- voice pass 完成后，再处理标题、阅读大纲、编号、表格、图片位置和 Markdown 格式。
- 再运行一次
python3 {baseDir}/scripts/check_article_style.py <markdown-file>。剩余提示要么继续修，要么说明为什么保留。
- 最后只汇报高价值信息：改掉了哪些 AI 味模式、哪些事实或观点边界没有动、还有什么残留风险。
优先级
当目标冲突时按这个顺序处理：
- 去 AI 骨架：先拆模板，不追求漂亮、对称、官方。
- 观点不变：不软化用户核心判断，也不替用户变得更激进。
- 观点归属准确：用户、协作者、公开资料、模型推断要分清。
- 技术准确：保留边界、前提、例外和不确定性；事实可能变化时要查证。
- 像人写的推理：优先写判断、原因、后果、限制和下一步。
- 中文自然：少白皮书腔，少模板转折，少抽象升华。
- 结构清楚：只在能减轻阅读负担时使用标题、列表、表格、引用。
中文 AI 写作痕迹模式
按中文技术文章重新命名和解释这些高频问题：
- 空泛意义升华：把一个普通事实写成“标志着、证明了、体现了、奠定了基础”。
- 背书堆砌：堆媒体、专家、行业报告，但不给具体观点或上下文。
- 句尾强行升华：句子后半段硬接“彰显、反映、确保、展示、象征”等总结词。
- 宣传和广告腔：无缝、直观、强大、充满活力、重要抓手、战略高地。
- 模糊归因：专家认为、行业报告显示、观察者指出，但没有可核验来源。
- 套路化挑战与展望：用“尽管面临挑战，未来仍然光明”收尾。
- AI 高频词：此外、值得注意的是、深入探讨、复杂格局、关键作用、赋能、闭环、降本增效。
- 绕开简单判断：不用“是/有/能/不能”，改成“作为/代表/标志着/具备能力”。
- 否定式排比：不是...而是...、不仅仅是...更是...、而不是。
- 三件套结构：强行列三点，或每个列表项都用粗体小标题加冒号。
- 人工感叠词：稳不稳、能不能、会不会、算不算这类连续判断句，尤其一口气排三四个。
- 刻意拟人口吻：我的判断很直接、很扎心、很现实；像模型在模仿“人类犀利表达”。
- 固定关注句式：相比较...我更关心这几个问题；大家最容易盯着...；这些句子出现频率太高。
- 生产系统排比：可接入、可上线、可控成本；稳定、可计费、可迁移、可治理这类密集排比要谨慎。
- 同义词循环：为了避免重复反复换词，导致概念不稳定。
- 虚假跨度：从 A 到 B、从 X 走向 Y，但 A/B 不构成真实尺度。
- 风格痕迹：破折号滥用、粗体滥用、emoji 装饰、标题过大过空、聊天回复残留。
- 通用积极结论：最后用“未来可期、迈出重要一步、持续追求卓越”替代真实结论。
详细解释和保留示例在 references/style-guide.md。
用户口吻规则
优先保留这些声音：
- 有真实判断：
我的判断是、我更倾向于、我的经验是、说实话。
- 有边界：
这只在...前提下成立、这里不能直接下结论、这件事没那么乐观。
- 有工程感：交付、成本、权限、评测、迁移、稳定性、可观测性、长期维护。
- 有明确主线：先讲要交付什么，再讲知识库、Skill、MCP、Git、Eval、框架这些手段。
- 有必要的锋芒：
别神化它、这个想法挺偷懒、复杂度不会消失，只会转移。
少用或不用：
不是...而是... / 而不是 / 不仅仅是...更是...到了...到底是什么 / 真正拉开差距的到底是什么这篇文章想回答一个问题 / 本文将如果只看...你会觉得...但如果深入看...过去比的是...现在比的是...现在比的是三件事 / 可以从几个维度看大家最容易盯着...接口稳不稳，工具调用能不能...成本能不能...升级会不会...我的判断很直接 / 我的判断很扎心 / 我的判断很现实相比较...我更关心这几个问题可接入、可上线、可控成本 这类密集排比换句话说 / 值得注意的是 / 综上所述一方面...另一方面...，除非真的是不可合并的两种约束赋能 / 闭环 / 降本增效 / 深度探讨
改写边界
必须遵守：
- 不新增原文没有支撑的年份、数字、案例、来源、产品能力、用户反馈。
- 不删除保护准确性的 caveat。
- 不把主观经验改成中立白皮书语气。
- 不把不同协作者的观点合成一个虚假的共识。
- 不为了“人味”把每段都写成第一人称。
- 不因为脚本只给
WARN 就保留明显 AI 骨架。
可以做：
- 调整段落顺序，让主张更早出现。
- 删除重复例子、空泛背景、模板转折和总结套话。
- 把假问题改成判断句。
- 把三段式 lead-in 改成更短的标准句。
- 把抽象阶段变化改成具体后果：成本、接口、迁移、部署、权限、评测、维护。
常见任务
改一节
- 保留标题，除非用户要求重命名。
- 先找这一节最强主张，把它放到前面。
- 如果第一段是铺垫、假问题或模板对比，直接重写。
- 删除为了显得完整而重复的例子。
- 保留个人判断和技术边界。
改 AI 生成初稿
- 先提炼真实主张。
- 尤其重写开头 3-5 段；开头保留 AI 节奏，全文都会像 AI。
- 以“判断 + 原因 + 边界 + 后果”重建段落。
- 保留原作者可识别的观点，不改成另一个作者。
改标题
标题要带判断或冲突，不要只是抽象概念。
可接受方向：
Agent 应用，先想清楚你要交付什么全通用型 Agent？一个答案求解所有问题的美丽幻想Agent 框架非彼框架Agent 到底如何做测试？是否要写测试集？
发布前检查
- 阅读大纲和
## N. 正文标题完全一致。
- 章节编号连续。
- 开头没有假问题、模板对比、阶段口号。
- 没有明显 AI 写作痕迹残留：升华、宣传、模糊归因、三件套、聊天残留、人工感叠词、刻意拟人口吻。
- 强判断来自原文或用户意图，不是模型新编。
LLM Wiki / MCP / Agent / Git / RAG / Skill 大小写一致。- 粗体只用于真正要记住的判断。
- 总结短，不重复整篇 checklist。
资源
references/style-guide.md：中文 AI 写作痕迹模式、大量改写示例、用户技术文章专用规则。python3 {baseDir}/scripts/check_article_style.py <markdown-file>：辅助定位固定句式、结构不一致、格式问题和疑似 AI 味段落；不会自动改写。
