Write zh

Skill initxy/initxy-skills/skills/self/write-zh

Make any repo AI native — fewer skills, conventions over steps, so any agent can cold-start, implement, self-verify, and write its decisions back.

Install

npx -y skills add initxy/initxy-skills --skill write-zh

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Guides the user through writing a Chinese document section by section — interviewing out real material, clarifying intent, co-defining an outline, drafting each part with every claim traced to material, restructuring when drafting exposes gaps, and cold-reading as the target reader — to produce diagram-rich, first-principles prose free of AI-flavored writing. Use when the user wants to write, draft, or co-author a Chinese article, blog post, essay, design doc, README, or long-form document with guidance instead of one-shot generation.

SKILL.md

7.4 KB, as published. Nobody here has run it

引导式中文写作

核心原则

好文档不是把要点填进模板,而是把一个问题想透之后,自然长出来的结构。

素材是第一瓶颈:文章的不可替代性,全部来自只有作者有的东西——亲历、数据、判断。这些恰是模型没有的,所以要先挖出来,再落笔。

所以这个 skill 的动作是「引导用户想透 + 帮他落笔」,不是「替他生成一篇」。一句话喂进去吐出整篇,正是 AI 味的根源:立意、素材、结构、措辞被压扁成一步,每一步都取了平均值。

子文件

正文只放流程和默认风格。三件事的细节拆在 references/ 里,在对应环节去读:

写作技巧(references/techniques.md):人味从哪来。起草任何一节前先读。
去 AI 味(references/de-ai.md):完整清单和正反例。起草时对照,收尾时逐条扫。
语言风格(references/styles.md):五种可切换的风格画像。用户想换风格、或拿不准用哪种声音时读。

何时用

主打:有想法密度的技术/思考长文、博客、随笔。也能写设计文档、README、提案。
两个入口:
- 从零写:走下面完整三阶段。
- 已有草稿:跳过阶段一,直接进阶段三(冷读 + 去 AI 味 + 风格 + 配图),需要时再回头补结构、补素材。

工作方式

逐节推进,中等颗粒度,允许回撤。不一次代写整篇,也不做「每节抛一堆选项让用户勾选」的重流程。

阶段一 · 访谈挖素材、定立意、共定大纲

素材分三类,来源不同,处理也不同:

类型	例子	怎么来	角色
脑内材料	亲历、踩过的坑、判断、立场	只能访谈问出来	主素材,立意从这里长
外部材料	文档、链接、代码、数据	用户直接给,读掉入库	证据库,不当内容源
缺口材料	缺的数字、引用、对比	大纲定型后反推	用户补,或联网搜

先访谈,后收料:先收文档,注意力会被文档锚定,写出来就是文献综述。访谈一次只问一个,等回答再问下一个,从里面挖:

触发:什么事让你现在想写这篇?具体事件比抽象观点值钱。
具体化:把抽象说法还原成一个场景——当时发生了什么,你怎么反应的?
分歧:这个话题上,你和主流看法哪里不一样?
转折:有没有改变过想法?之前信什么,什么打破了它?
数字:有没有能量化的东西?粗糙估计也行。
读者:写给谁?读完应该改变什么——知道什么、相信什么、会做什么?
约束:目标平台、篇幅、格式?用哪种风格(默认底色,还是 styles.md 里某一种)?

再收外部材料,然后做第一性拆解:把题目拆到不能再拆的基本事实和硬约束,从这些往上推,而不是先套一个现成结论或别人的框架。

共定大纲后,落成两个并排的文件:

大纲骨架 .md:每个小节一个标题加占位,作为逐节填充的脚手架。
素材文件 material.md:访谈挖出的和外部收来的,逐条编号,注明来源。

最后拿大纲反推缺口:哪个论点还缺证据,列成清单——用户能补的再挖一轮,没有的联网去搜。

阶段二 · 逐节推进

从最不确定的小节先写,通常是核心论点;开头和概述留到最后。对每个小节:

先从 material.md 里找这节能用的素材;不够就问用户要,新挖到的补进素材文件。
起草这节。起草前先把 references/techniques.md 过一遍,落笔就用上;同时套用下面「风格」「配图」的规则,并对照 references/de-ai.md 不犯常见 tell。
用户提修改,用 Edit 局部更新文件,不重印全文。

硬规则:每个论点必须能指到 material.md 里一条具体素材。指不到的,要么回去补素材,要么砍掉——这条同时挡住空转和编造。

起草会暴露大纲的洞,这是写作在正常工作,不是失败。出现以下信号就回撤,先改大纲再继续,不硬着头皮往下填:

某个论点指不到素材,补也补不出来。
两个小节写着写着在说同一件事。
某节里长出了比原大纲更有力的主线。

阶段三 · 冷读收尾

先冷读:切换成目标读者——不知道任何背景的那个人——从头读一遍,标出每个「这里我跟丢了」的位置:没铺垫就出现的概念、跳步的推理、只有作者才懂的指代。逐个修掉。
用 references/de-ai.md 的速查清单整篇扫一遍。
查风格是否前后统一(同一篇别一段科普一段硬核地跳)。
查图够不够、贴不贴、标签是否具体。
收尾要轻:不写「总结 / 结语 / 写在最后 / 希望对你有帮助」式套话。

风格

默认底色:两条主线,主次分明。想要别的声音(清淡科普、老练实战、口语个人、严谨工程……),去 references/styles.md 选一种为主。

第一性原理(主)

论证靠事实和约束推导,不靠类比、不靠「业界一般认为」「大家都知道」推进。
遇到现成结论先问「凭什么」,把它还原成可检验的前提。
和传统冲突时,从头推优先。诉诸先贤不能替代论证。

传统文化(淡淡点缀)

偶尔一句契合的诗词、古文、典故,只在它真能点睛时落,绝不为引而引。
宁少勿滥:整篇以现代白话为底,一两处足矣。堆古文就是失败。

语气

像一个已经想清楚的人,平静地讲给同行听。不端着,不煽情,不喊口号。

配图

每个核心概念、流程、对比、结构,配一张图。能用图说清的,就别写一大段。默认用 mermaid。

思维模式对应图类型:

想表达	用
拆解 / 概念结构	mermaid mindmap 或 graph
流程 / 时序	flowchart / sequenceDiagram
分类 / 对比	markdown 表格或 quadrantChart
因果 / 依赖	有向 graph
第一性推导链	自顶向下 graph,从基本事实推到结论

约定:

图用真实标签,不用「模块 A / 模块 B」这种占位。
默认 mermaid 内联,可进 markdown、可版本管理、好改。
目标平台不渲染 mermaid(比如公众号),提示用户把图导出成图片再贴。
要做精致的演示级架构图,交给 architecture-diagram skill,这里不重造。

完成标准

也是 review 的验收口径:

第一性结构成立:核心论点是从事实和约束推出来的,不是套来的。
论点可溯:每个论点都指得到 material.md 里一条素材,没有空转和编造。
冷读通过:目标读者从头读到尾不跟丢,概念都有铺垫,推理不跳步。
de-ai.md 速查清单全过,没有残留 tells。
核心概念都有图,图贴切、标签具体。
风格统一:整篇一种主声音;默认底色则第一性为主、传统点缀不过量。
事实可核,数字、引用、代码真实可用。
收尾不套话。