plain 是一个写作技能,用于把面向人阅读的文字写得简单清楚。资料给出两种使用方式。
解释模式。调用方式为 plain 重新解释上一条消息,或 plain <问题> 解释该问题。写作前先确定上下文:仓库、任务和刚发生的事。优先使用对话内容;在新会话中可读取 git status、git log --oneline -5,以及存在的 .workflow/<slug>/ 最新产物。回答按以下顺序写:当前进度,用一句话说明仓库、任务和最后一步;简短回答,用两三句能独立成立的话;必要细节,只写问题需要的部分,用本仓库的具体例子优于类比,并顺带解释仓库术语;需要读者决定或行动时,给出带字母编号的选项和推荐默认项。写完对照规则检查,除非读者要求深入,控制在约 200 词以内。解释模式不写文件。若读者需要留存或引证,末尾提示 understand <area> 会写带引用的说明页。
重写模式。调用方式为 plain rewrite <文件>,或对粘贴文本使用重写触发。重写时遵循全部规则,保留每个事实、数字、名称、链接和代码片段,并保持原定语气。写完后按规则自审并修正。指定文件就地编辑,粘贴文本以文本形式返回,并用一行说明做了哪类改动,指出因保持平实而无法保留的事实。
规则适用于散文,即聊天回答、报告、卡片、决策、说明页、README 等。代码、命令、文件路径、标识符、必须逐字保留的引文和 [1] 这类引用标记不属于散文,保持原样。主要规则包括:一句一个意思,步骤句不超过 20 词,描述句不超过 25 词;段首先给要点,每段最多六句;用主动语态和现在时;写完整句子;三个以上步骤用列表,比较用表格;一个概念固定用一个词;术语首次出现时用平实语言解释;避免 utilize、leverage 等词;避免一批 AI 常用词和隐喻名词;说 is 和 has;用强动词、少用副词;说清机制而非感觉;不用格言、比喻动词和拟人化;直接陈述,不用“不只是 X,而且是 Y”;指明来源;删除空洞的 -ing 结尾;不用虚假范围;只做一次模糊限定;结尾具体;删除填充语;不用破折号、散文中的括号、装饰性表情符号;标题用句首大写;用直引号;不用聊天机器人套话。写完自问“什么让这段文字明显像 AI 生成”,修正后再逐条检查。
适用场景是简化技术解释、为切换项目的读者重建上下文、按统一风格改写文档。限制:资料未提供安装命令、收费、平台支持或效果数据;规则中的词表是写作约束,不是产品功能承诺。