SuperAPI AI 工具集

line-layout

写作与研究

查看项目

更新于 10-16 17:28

技能介绍

line-layout(换行与空行)是一个日语说明文的排版技能。句子的内容由前序工序(段落组装、句子规范、可读性改写)决定,本工序只处理既定句子如何排列。

用途

当长句后不换行而直接接下一句时,阅读会变得困难。在主张、理由、具体内容并排在同一行的段落中,读者需要自行寻找角色在哪里发生变化。本技能用于整理日语说明文的换行与空行,适用于需要给人阅读的日语说明,例如 README、解说、报告、Discord 或 Qiita 文章等。

主要能力与规则

一、按句换行

句点(“。”“!”“?”)结束一句后换行,一行一句。

引号中的句点不切分(例如写着“保管庫です。”时)。

包裹整句的圆括号((補足です。))在闭括号之后切分。

行内代码中不切分。

列表项、表格、标题、代码块中不换行。若在列表项中换行,在 Discord 中会看起来像是跑到项目之外,在 Markdown 中则需要对后续行缩进。若一个项目需要两句以上,应缩短句子或改为正文段落。

二、按角色块插入空行

以“具有单一角色的句块”为单位用空行分隔,可比段落更细。角色示例包括:主张(在做什么、想说什么)、理由与机制(为什么会这样)、具体内容(在哪里、什么、什么数值)、条件与例外(什么情况下不同)。

块中的句子应只是持续说明同一角色的句子。角色改变时插入空行。

即使用空行分开,块与块之间的关系(理由、具体化、对比)仍要在句子中体现。空行只传达“角色改变”。不能因为插入空行就删去“そのため”“具体的には”之类表示关系的词。

一个块可以只有一句。标题之后紧接着一个单句块也可以。

使用方式

路径相对于存放本 SKILL.md 的目录。

  1. 对写完的正文运行 python3 scripts/layout.py <file> --fix,实现按句换行。

  2. 阅读同一脚本提示“段落中有 N 句”的段落,按角色插入空行。没有提示的段落,如果混有两种以上角色也要分开。

  3. 插入空行后,若一个块的主张与前后不连贯,则用句子补上连接(回到段落组装)。

脚本与测试

scripts/layout.py — 检查(违规时退出码为 1)与 --fix(仅机械插入按句换行,不插入空行)。

tests/test_layout.py — 运行 python3 -m unittest discover -s tests。

显示注意事项

在 GitHub 等将 Markdown 单行换行显示为空格的地方,按句换行不会在视觉上体现。因此在那里形成视觉分隔的只有空行(段落),需要用角色块的空行来分隔。在 Discord 或 Qiita 中,单行换行会直接显示,因此按句换行也直接可见。

限制

本技能只处理既定句子的排列,不改变句子内容。空行需要人工判断,脚本不自动插入空行。其他功能、收费、价格、支持平台或效果等资料暂未提供。