用途:对政治学等学术领域的 Quarto(.qmd)手稿做散文质量检查,依据 William Zinsser《On Writing Well》第30周年纪念版的原则,输出独立报告,不修改源文件。
主要能力:按六类检查——冗余(CLUTTER)、弱动词与过度修饰、语态与陈词滥调、统一性与范围、开头与结尾、解释清晰度;覆盖正文、YAML 前置元数据的散文字段、代码块标题、图表标题;将 Quarto 标记(@fig-、@tbl-、短代码、@author2024)视为不透明内容,不检查代码块内部。问题按文档章节组织,标注 CRITICAL 或 MINOR,并给出原文、建议改写与 Zinsser 章节依据。
使用方式:调用 /write-well,第一个参数为 .qmd 文件路径(必填),第二个参数为报告输出路径(可选,默认在同目录生成 <输入文件名>-writing-edits.md);可传入 @sec-label 形式的 Quarto 章节引用,仅检查该章节。示例:/write-well paper/paper.qmd;/write-well paper/paper.qmd @sec-intro;/write-well paper/paper.qmd @sec-data reviews/methods-writing.md。若找不到对应标签,会停止并列出文件中所有 {#sec-*} 标签。
适用场景:学术论文写作润色、投稿前自查、按章节局部检查。
限制:不修改源文件;不检查代码块内容;语法、拼写与标点应使用 proofread 技能,APSA 格式规则应使用 apsa-style 技能;具体安装方式与运行环境要求暂未提供。