写作
这是写文章、修改文章时遵循的规范。
对读者（人类）的阅读方式和思考方式，遵循 humanity-and-humanness。
日语的措辞遵循 philtzjp/skills 中的 japanese。
本技能的规范是在此基础上追加的内容。
为什么需要本技能，以及希望达到的状态
之所以需要本技能，是因为 AI 往往不是根据“要让读者做出什么判断”来组织句子，而是反射性地按照学习到的说明文形式来拼装。因此句子缺少理由；文中会堆入越来越多可从代码推导出来的、会过时的信息；反射性添加的逗号会形成不自然的节拍；全文会停留在同一种认知模式中，显得平淡。此外，AI 还会把“能原样读懂所写内容的自己”当成读者模型。对于会一边推测一边阅读的人类来说，这样的文章条目数不清、无法跟上行文节奏，读完后也留不下印象。这种习惯会让读者疲劳，并让重要的判断标准被掩埋。
本技能希望达到的状态是：文章能让读者只读一遍就接收到写作者的判断及其理由，并且能一直读到结尾。
大原则
规范不是机械套用的句式或禁止事项。首先要确定的不是“怎么改”，而是“这个修改要守护文章的什么”。要根据文章发挥的作用来判断，而不是根据形式。
配合读者阅读方式的构成
人类按顺序阅读，并按照阅读顺序构建理解。人们不会先一览整体把握全貌再进入细节。文章结构要配合这种阅读方式。
一份文档只放一种类型
在罗列规则之前，先写清楚如果没有这条规则会发生什么
只靠标题和开头就能看出这是什么文档、要守护什么
用短句段落写明这是什么文档，用项目符号列出要守护的内容
并列的项目要写成列表，不要压进行文里
指向其他文件或章节的索引要附上一行摘要
一个句子只放一个独立判断
同一层级的标题要回答同一个问题
标题要承载要点而非话题名。步骤的标题用动词短语，概念的标题用名词短语
文档有四种类型：用于工作的步骤、用于工作的事实参考、用于理解的说明、用于学习的步骤。读者会按类型改变阅读方式，因此如果在步骤中写背景、在参考中写说服，读者就无法切换阅读方式。想混合时，应拆分文档并建立链接。
同一层级的标题视角不一致时，读者即使一览也无法把握是按什么轴划分的。不要把规则章节、步骤章节和对象章节放在同一层级。
如果先罗列规则、后补充理由，疑问就不会产生，行文也就没有流动感。从必要的理由到希望达到的状态、大原则、规则这样的结构，就是把这种流动感应用到整篇文档。
一个句子中有多个判断时，人类会跳读并用推测填补，而 AI 会全部执行。两者的认识就在这里错位。
节奏设计
也要阅读 rhythm。
高密度文章之所以无聊，不是因为信息多，而是因为全文都用同一种认知模式写成。要让读者的认知模式在观察、困惑、确信、再确认之间切换，并始终保留“继续读下去的理由”。
节奏不是信息量的增减，而是认知模式的切换
始终保留一个未回收的紧张
不要用解释已完成结论的旁白口吻，而要用一边思考一边推进的当事者口吻来写
节拍、紧张和松弛的材料只能从情境一侧获取
装置要通过内容实现，不要宣告出来
不要为了制造节拍而删减句子
当所有紧张都闭合的瞬间，读者就可以停止阅读。未回收的紧张是指尚未得出答案的问题、尚未验证的确信、约定之后再给出答案的内容。
情境是指对象世界中的事件、数据、发言，以及叙述者的判断状态。在没有场景的说明文中，对象本身的性质以及读者抱有的推论和反问就属于情境。情境中没有材料的位置，就不要添加任何东西，保持平坦。用讨论本文自身的句子来制造节奏，是违反规范的行为。
像“先放出一半答案”这样描述接下来要做的操作的句子，本身就是劣文。如果装置有效，读者不会注意到装置的存在。
为了缩短而删去范围、视角、比较轴、未确定事项等导入所必需的上下文，不是节奏，而是缺失。提高密度的编辑只能在已共享的上下文之上进行。
规范
写说明文时，还要全部阅读以下内容。
purpose-and-reason。写目的与理由
no-perishable-information。不要把可从代码推导出的信息复制到文档中
punctuation。句读要点在角色边界和语义确定的位置
purpose-before-means。手段之前先放目的
headings。标题和项目符号用体言止（名词短语收尾）
用途
usecases/ 是撰写特定文章的手顺。
ai-context。撰写 SKILL.md、AGENTS.md、CLAUDE.md 等 AI 阅读的文档
readme-md。撰写 README.md，帮助人类决定是否使用并开始使用
novel。写小说