SuperAPI AI 工具集

yzr-writing-style

写作与研究

查看项目

更新于 10-20 04:53

技能介绍

用途 该技能是一份公共写作风格规则集,服务于两类任务:写作时按规则产出成文内容(文档、README、wiki 页、总结等);审计时以同一规则集为标尺检查已有文档风格。当用户要求多模型或交叉评审时,发现生产环节改走多模型编排,报告与确认步骤不变。

主要能力 规则集以资深架构师视角为立场,强调语言精炼、准确,让读者读得舒服、直接、不冗余。规则集是唯一风格标尺:写作只照它写,审计只照它查,集外问题不报;写作遇规则未覆盖的情形按立场裁量,审计不拿立场当发现依据。具体行文规则包括:结论先行,先给结论再给依据,先重要后次要;删除删掉后信息量不损失的冗余,如注水开头结尾、同义重述、填充句、近义词并列;写可验证的事实与具体动词,“进行/实施/做出+名词”直接写动词,无数据不编造;中文单句超 60 字拆分,一段一个论点,并列项结构对齐;同一概念全文同一叫法,指称用具体名,不用“方案 1”式编号代称和落空指代;陈述句直陈主张并附依据,商量句式改陈述,多重对冲一句最多一个,敬语能省则省;标点跟随所在句主体语言,中文全角、英文半角,代码、URL、数值内部例外;行文只用常规全角标点,不用全角字母数字与全角空格;清单用列表、数据用表格、关系与流程才用图,文档图用 Mermaid,不渲染场景才用 ASCII 图;图旁只留结论,不重复图内信息;ASCII 图框内纯半角、中文不进框。AI 腔专项规则包括:正文说清后不再“综上所述”复述;加粗只留扫读定位用的术语定义与警告;一句话能说清的不拆 bullet;非对话文体不写自问自答;删开场捧场与营销词,感叹号全文最多一个;行文不用 emoji、Unicode 箭头、破折号、角引号与图形符号,插入语改括号或逗号。

使用方式 工作流分写作与审计。写作:明确题材、读者与交付位置,按规则集写作,交付前逐条对照自查;产物落文件时从 skill 根运行 python3 tools/scan_fingerprints.py <产物> 机检,命中清零才交付。审计:通读目标文档,从 skill 根运行 python3 tools/scan_fingerprints.py <目标文档> 拿机械候选,再逐条对照规则集全部条目补齐,出报告时每条发现附规则名、原文引用与修改方案,琐碎项(错别字、个别标点)不进报告,报告只在对话内输出、不落文件;报告交用户,同意后按方案改文件,只动行文不动语义,事实、数据、结论、引用一克不少。

适用场景 适用于 agent 输出成文内容的场合,以及用户提到审计或检查文档风格、多模型交叉评审的场合。

限制 不适用于内容正确性与事实核查。审计只交付报告与修改方案,文件改动须经用户同意后执行。