Writing style rules
收藏资源简介:
该项目从63个知名风格指南和写作参考中收集写作风格规则,并将其组织成一个清晰的集合。目标是提供一个单一的风格规则来源,可以提供给AI写作助手,使其按照这些指南的方式写作。目前该集合包含814条规则,规则分为68个类别,这些类别又分为15个大组。每条规则都保留了其来源指南列表、帮助读者的原因以及简短的修改前后示例。
This project collects writing style rules from 63 well-known style guides and writing references, and organizes them into a curated collection. The objective is to provide a single authoritative source of style rules that can be provided to AI writing assistants to enable them to produce text in line with these guidelines. Currently, this collection includes 814 rules, which are categorized into 68 subcategories, and these subcategories are further grouped into 15 major groups. Each rule retains its list of source guides, the rationale for assisting readers, and concise before-and-after revision examples.
数据集概述
该数据集收录了从 63 个知名风格指南与写作参考中提取的写作风格规则,并将其整合为一套统一的规则集。目前共包含 814 条规则,分为 68 个类别,这些类别进一步归纳为 15 个更大的分组。每条规则均保留了来源指南列表、对读者的帮助理由,以及简短的修改前后示例。
核心数据文件
writing-rules.json:主文件,规则按分组和类别组织,包含元数据(规则数量、来源列表)。writing-rules.flat.json:规则的扁平化列表(由主文件自动生成),每条规则包含以下字段:id、rule、applies_to、rationale、example_violation、example_fixed、sources、group、category。
数据构建流程
构建过程分为三个步骤:
- 提取:从每个指南中提取具体的写作风格规则,生成原始规则池(
data/pool.json)。 - 聚类:基于规则内容自动构建类别,并将每条规则分配到其中一个类别(使用
workflows/cluster.js)。 - 去重:在每个类别内部合并语义相近的规则,合并其来源列表(使用
workflows/dedupe.js),最终生成writing-rules.json。
数据浏览与使用
- 可视化浏览:直接在浏览器中打开
dashboard.html,无需服务器或构建步骤。可按分组浏览、打开类别、搜索规则文本。每条规则显示其理由、修改前后示例及来源。 - 代码处理:读取
writing-rules.flat.json文件进行编程式处理。
新增规则来源
可通过 Claude Code 运行 add-writing-rules 工作流自动添加新来源:
- 自动搜索网络上未收录的权威写作指南(每次最多新增 4 个来源,可通过
MAX_WEB_SOURCES变量调整)。 - 也支持手动将指南放入
sources/queue/目录。 - 新规则将适配到现有类别中,重复内容合并来源,否则作为新条目添加。
- 运行完成后自动更新扁平文件、可视化页面和来源记录。
可调度运行
支持定时运行添加工作流,使数据集持续增长:
- 通过 Claude Code 调度:可设置为每日运行,但仅在 Claude Code 打开时执行,有效期 7 天。
- 通过 crontab 调度:使用
scripts/add-from-queue.sh脚本,可在后台永久运行。示例配置为每天上午 9:17 执行。
手动重建
若手动编辑 writing-rules.json,运行以下命令重建衍生文件:
node scripts/build.js
该命令将重写 writing-rules.flat.json 和 dashboard.html,并更新元数据中的统计计数。




