Skip to content

Yila-AI/awesome-defensive-writing / skills/yila-clear-writing

yila-clear-writing

Verified

Diagnose and revise AI defensive padding in drafts, reports, emails, research prose and public explanations when the user requests less hedging or clearer claims. Preserve evidence strength and meaningful reader guidance.

references/examples-zh.md

View on GitHub
# 完整改写案例

[English](examples-en.md) | **简体中文**


以下情景案例依次给出输入事实、问题稿、推荐改写与修改理由。选取相近的任务,替换为自己的材料即可练习。

- [EX-01 同一事实,清楚表达](#ex-01)
- [EX-02 预测不能变承诺](#ex-02)
- [EX-03 观察研究的结果](#ex-03)
- [EX-04 贡献与审稿回复的完成状态](#ex-04)
- [EX-05 目标与成果要分开](#ex-05)
- [EX-06 真实依赖与备选路线](#ex-06)
- [EX-07 接口阻塞与排期](#ex-07)
- [EX-08 复盘与资源请求](#ex-08)
- [EX-09 有礼貌地拒绝扩展范围](#ex-09)
- [EX-10 求助、真实身份与承担责任](#ex-10)
- [EX-11 产品能力与内测范围](#ex-11)
- [EX-12 用户案例不等于效果保证](#ex-12)
- [EX-13 有观点,也有来源边界](#ex-13)
- [EX-14 解释预印本,不替研究扩张结论](#ex-14)
- [EX-15 教程必须保留路径](#ex-15)
- [EX-16 操作禁令和真实权衡](#ex-16)
- [EX-17 图表里的分母与样本](#ex-17)
- [EX-18 负结果:没有显著差异,不等于等效](#ex-18)
- [EX-19 学习记录不等于熟练](#ex-19)
- [EX-20 经验、资源与下一步](#ex-20)
- [EX-21 代码评审要有触发条件](#ex-21)
- [EX-22 按目标选择,完整报告性能代价](#ex-22)
- [EX-23 综述不能假装读过文献](#ex-23)
- [EX-24 直接回答费用问题](#ex-24)
- [EX-25 催进度:明确约定与回复时间](#ex-25)

<a id="ex-01"></a>
## EX-01 · 同一事实,清楚表达

**输入事实**

会议纪要已经确认:原型周四交付;测试在交付后进行。这里的“交付”指原型,不指测试完成。

**冗余或错误稿**

考虑到项目存在一定复杂性,我们可能会尽量争取在周四交付原型。当然,这并不意味着所有工作都已经结束。

**推荐改写**

原型周四交付,随后进入测试。

**为什么这样改**

材料已有明确交付约定,删掉重复弱化承诺的词;用后续测试说明工作范围。

**必须保留的边界**

若周四只是内部目标而非确认承诺,应写“目标是周四交付”,不能照搬本例的确定语气。

<a id="ex-02"></a>
## EX-02 · 预测不能变承诺

**输入事实**

按当前负载估算,任务预计周四完成;若周三收到新增数据,预计改为周五。未向客户承诺固定日期。

**冗余或错误稿**

项目完成时间可能或许在周四左右,但情况比较复杂,仍有较多不确定性。

**推荐改写**

按当前负载,预计周四完成;若周三收到新增数据,预计周五完成。

**为什么这样改**

把叠加的可能性改成明确预测,补回材料中会改变日期的条件。

**必须保留的边界**

必须保留“预计”与新增数据条件;不能改成“周四完成”。

<a id="ex-03"></a>
## EX-03 · 观察研究的结果

**输入事实**

教学虚构数据:单中心观察研究,120 名成年人;A 与 B 的 Pearson r=0.32,95% CI 0.15–0.47。未随机分配,也未进行因果识别。

**冗余或错误稿**

结果可能在一定程度上提示 A 或许与 B 存在某种联系。还需更多研究,不能草率下结论。

**推荐改写**

在这项纳入 120 名成年人的单中心观察研究中,A 与 B 呈正相关(r=0.32,95% CI 0.15–0.47)。

**为什么这样改**

直接报告观察结果,设计、样本和区间共同说明证据范围;不需要再用空泛句弱化相关这一发现。

**必须保留的边界**

不能改成“A 导致 B”;如果上下文已有因果误读,需要明确纠正,不能把因果提醒一律删掉。

<a id="ex-04"></a>
## EX-04 · 贡献与审稿回复的完成状态

**输入事实**

教学虚构研究:团队整理了 2019–2023 年三个城市的公开预算字段,统一编码并提供脚本;现有文献笔记只覆盖两篇相关工作,不能支持“首次”。审稿人要求全国推广论证。作者已将结论限定为这三个城市,未新增其他地区数据,也未做代表性检验。

**冗余或错误稿**

我们的工作仅仅做了一些初步整理,贡献十分有限。我们完全同意审稿人的意见,并已补充充分分析证明适用性。

**推荐改写**

本研究统一了三个城市 2019–2023 年公开预算字段的编码,并提供处理脚本。针对全国适用性的意见,我们已将结论范围限定为这三个城市;现有数据不能支持全国推广。

**为什么这样改**

保留实际贡献,删除自贬与虚构分析;明确作者实际完成的范围修改。

**必须保留的边界**

本例的不可全国推广说明有实质作用。不能只写“关注三个城市”后在别处继续声称普遍适用。

<a id="ex-05"></a>
## EX-05 · 目标与成果要分开

**输入事实**

虚构项目:图书馆现用表格人工登记预约;三次工作人员访谈报告重复录入。团队已获得两周沙盒访问,计划制作预约表单原型,并用预设的五条测试记录检查必填字段和重复提交拦截;尚未完成开发,没有用户规模数据。

**冗余或错误稿**

预约管理已成为影响数万用户的严峻问题。我们或许可以尝试探索一些改进,目前已经显著解决了重复录入。

**推荐改写**

三次工作人员访谈反映预约登记存在重复录入。项目计划在两周沙盒期内开发预约表单原型,并用五条预设记录检查必填字段和重复提交拦截。

**为什么这样改**

用材料支持的问题和可检查目标替代虚构规模、笼统尝试及伪造完成状态。

**必须保留的边界**

访谈不能证明问题的总体发生率;五条记录是功能检查,不是有效性研究。

<a id="ex-06"></a>
## EX-06 · 真实依赖与备选路线

**输入事实**

虚构项目:流程为拿到授权数据、清洗、试跑。计算资源已可用,数据授权仍待审批,周五是团队决策节点。团队确定:若周五仍未获批,下周先用公开样例检查流程;公开样例不能替代项目数据完成最终评估。

**冗余或错误稿**

项目存在较多复杂风险,数据问题可能导致一切无法推进,所以目前很难判断是否可行。

**推荐改写**

计算资源已就绪,数据授权待审批。若周五仍未获批,下周先用公开样例检查流程;最终评估仍需获授权的项目数据。

**为什么这样改**

用已知资源、触发条件和可行备选替代整体否定。

**必须保留的边界**

不能把公开样例试跑描述为项目评估已经完成,也不能把待审批资源当成已获批。

<a id="ex-07"></a>
## EX-07 · 接口阻塞与排期

**输入事实**

虚构进度:页面开发已完成;接口权限未开通;联调尚未开始。原定周二交可联调版本,现调整为周四交。负责人请项目经理当天协调接口权限。以上为会议确认的新安排。

**冗余或错误稿**

整体推进顺利,我们一直非常努力。由于情况复杂,后续可能稍有延后,望理解。

**推荐改写**

页面开发已完成,接口权限尚未开通,联调未开始。可联调版本由周二调整为周四交付,请项目经理今天协调接口权限。

**为什么这样改**

写出完成状态、实际阻塞、新排期和需要的动作,删空泛努力表态。

**必须保留的边界**

不能写成“联调完成”;若新日期没有确认,须改用预计并说明依赖。

<a id="ex-08"></a>
## EX-08 · 复盘与资源请求

**输入事实**

虚构事件:周三交付延迟两小时;日志显示打包机磁盘已满,清理缓存后恢复。团队确认增加一次交付前空间检查;申请一块备用盘,预算上限 600 元,尚未批准。没有证据表明个人疏忽。

**冗余或错误稿**

我们还有很多不足,需要全面反思,相关人员可能不够认真。希望领导酌情考虑给予一些支持。

**推荐改写**

周三交付因打包机磁盘已满延迟两小时,清理缓存后恢复。团队增加交付前空间检查,并申请预算不超过 600 元的备用盘,待批准。

**为什么这样改**

用已核实原因与具体改进替代空泛反思,清楚提出尚未获批的资源请求。

**必须保留的边界**

不要把推测写成人员责任;不能把待批准预算写成已采购。

<a id="ex-09"></a>
## EX-09 · 有礼貌地拒绝扩展范围

**输入事实**

虚构协作:本周确认交付是中文摘要;对方新增英文全文需求,双方尚未约定。团队本周无余量,可在下周评估英文全文的排期,不能承诺下周完成。原中文摘要仍按周五交付。

**冗余或错误稿**

实在抱歉,我们能力有限,可能做得不够好,不过会尽量全部满足。

**推荐改写**

中文摘要仍按约定周五交付。本周无法增加英文全文;我们可以下周评估该需求的排期。请确认是否需要安排评估。

**为什么这样改**

明确保留原责任,并对新增需求设定真实边界;礼貌不需要靠虚假承诺实现。

**必须保留的边界**

下周评估不等于下周完成;已有中文交付不能一起拒绝。

<a id="ex-10"></a>
## EX-10 · 求助、真实身份与承担责任

**输入事实**

虚构邮件背景:学生林同学为本科三年级,做过一个课程数据清洗作业,没有论文。想询问导师是否愿意就数据质量选题给一次简短建议。学生曾约定周二发送材料,但因自己漏发未做到;材料现已备好附在邮件。

**冗余或错误稿**

学生水平很低,实在不敢打扰。之前的材料由于各种原因可能没能及时发送,给您添麻烦了。对于选题也许有一些不成熟的想法,还望指导。

**推荐改写**

老师您好,我是本科三年级的林同学,做过一个数据清洗课程作业,想请教数据质量选题。抱歉,我漏发了约定周二发送的材料,现已附上。若您方便,能否就选题给我一次简短建议?

**为什么这样改**

用真实身份和具体请求替代自我贬低,明确承认漏发材料并给出补救。

**必须保留的边界**

不能因去掉道歉式文风就删掉这次有实际责任的道歉;不能捏造导师研究方向。

<a id="ex-11"></a>
## EX-11 · 产品能力与内测范围

**输入事实**

虚构产品 P:本次内测名单中的用户可上传 PDF,选模板生成可编辑的图稿草案。尚未开放公众注册。未进行效率测试,没有免费政策或直接投稿质量保证。更新日志只能宣布此内测能力。

**冗余或错误稿**

我们或许能在一定程度上提供帮助。所有人都可免费使用,一键得到直接投稿级配图。

**推荐改写**

本次内测用户可上传 PDF、选择模板,生成可编辑的图稿草案。公众注册尚未开放。

**为什么这样改**

先说明可做的任务,同时保留资格与结果性质;删掉冗余退让和未证实宣传。

**必须保留的边界**

迁移到真实产品时,填入已确认的功能、用户资格、定价与开放状态。

<a id="ex-12"></a>
## EX-12 · 用户案例不等于效果保证

**输入事实**

虚构案例:用户甲授权匿名使用原话“我把零散笔记整理成了一份提纲”。记录显示用户先导入笔记、再人工修改生成提纲。没有用时、对照组或质量评分。FAQ 问“能否保证不用人工修改”。产品团队确认不能保证。

**冗余或错误稿**

这只是很初步的一点尝试,也许对某些人有帮助;已经证明能让所有用户效率提升十倍,完全不用修改。

**推荐改写**

用户甲分享:“我把零散笔记整理成了一份提纲。”这次使用包含导入笔记和人工修改。这个案例展示了一种整理方式,不保证所有任务都无需人工修改。

**为什么这样改**

使用已授权原话和真实过程,明确回答读者正在追问的保证问题。

**必须保留的边界**

这里的明确否定有用,不能为了正向表达删掉;无数据就不能写效率倍数。

<a id="ex-13"></a>
## EX-13 · 有观点,也有来源边界

**输入事实**

虚构口播材料:作者观察了三段自己的 AI 改写草稿,其中两段出现重复“仅供参考”。作者想演示逐句检查法。这只是个人观察,未做模型比较。视频为付费合作,须向观众说明。未提供任何论文数据。

**冗余或错误稿**

也许我的看法不成熟,大家别骂我。所有 AI 都因为道德感太高而只会说废话。

**推荐改写**

这期是付费合作。我检查了自己的三段 AI 改写稿,其中两段重复出现“仅供参考”。下面用逐句检查法,判断这些话有没有增加信息。

**为什么这样改**

个人观察足以引出教学,不足以支持所有模型的机制判断;保留商业披露。

**必须保留的边界**

不能伪称论文证明、扩大样本,或删掉合作披露。

<a id="ex-14"></a>
## EX-14 · 解释预印本,不替研究扩张结论

**输入事实**

教学材料给出的来源摘要:一篇预印本比较不同写作请求下的限定表达,讨论了审稿导向请求;摘要区分冗余限定与有助纠正过度主张的撤回。没有关于所有模型、所有领域或道德感机制的证据。读者问“是不是所有谨慎句都该删”。

**冗余或错误稿**

问题非常复杂,需要辩证看待,各种说法都有道理,可能不能一概而论。

**推荐改写**

不能只按措辞删句。这篇预印本区分了冗余限定与纠正过度主张的撤回:前者可能增加阅读负担,后者可能有必要。检查时要看这句话是否改变了结论的有效范围。

**为什么这样改**

直接回应读者问题,给可操作区分,避免用空泛平衡替代解释。

**必须保留的边界**

本例只使用给定摘要;不能补上未经提供或核验的实验数字。

<a id="ex-15"></a>
## EX-15 · 教程必须保留路径

**输入事实**

虚构离线工具说明:已验证 Windows 环境下手动复制整个 sample-skill 文件夹到客户端配置的 skills 目录;必须同时保留 references 子目录。重载客户端后检查是否出现 sample-skill。只复制 SKILL.md 会丢失参考。若未发现,先检查复制层级。未提供安装命令,也未验证其他系统。

**冗余或错误稿**

安装可能有各种风险,建议谨慎。复制一下文件就能在所有系统正常运行。

**推荐改写**

在已验证的 Windows 环境中,把整个 sample-skill 文件夹复制到客户端配置的 skills 目录,保留 references 子目录。重载客户端后检查是否出现 sample-skill;若没有,先检查文件夹是否多套了一层。

**为什么这样改**

保留环境、完整文件夹和可观察检查;删除抽象风险堆叠与全系统保证。

**必须保留的边界**

不能删 references,也不能凭空新增一键命令或默认目录。

<a id="ex-16"></a>
## EX-16 · 操作禁令和真实权衡

**输入事实**

虚构维护任务:设备须先断电,再打开检修盖;禁止带电开盖。维护记录要求记录设备编号与日期。路线 A 只整理记录,不需开盖;路线 B 需开盖才能检查内部接线,且只能在断电后执行。安全前提已由输入明确,不要求生成其他操作。

**冗余或错误稿**

请务必时刻牢记安全,尽量先断电后开盖。为了简洁,两条路线都可表述为直接检查设备。

**推荐改写**

路线 A:整理维护记录,保留设备编号与日期,无须开盖。路线 B:先断电,再开检修盖检查内部接线;禁止带电开盖。

**为什么这样改**

把说教转成明确操作要求,但保留禁止条件与路线差异。

**必须保留的边界**

禁止条件有实际意义,不能变成可选建议,也不能为简短把两条路线写成相同操作。

<a id="ex-17"></a>
## EX-17 · 图表里的分母与样本

**输入事实**

虚构图表:平台活动 A 有 20/100 人完成,B 有 30/200 人完成;两组为不同自愿报名人群,没有随机分配,时间段相同。目标是比较完成比例,不是完成总人数。

**冗余或错误稿**

B 的人数更多,所以 B 明显更有效。当然,也可能存在很多因素,不能说明任何问题。

**推荐改写**

A 的完成比例为 20%(20/100),B 为 15%(30/200)。两组为不同自愿报名人群,这个比较描述完成比例,不识别活动的因果效果。

**为什么这样改**

计算输入已足够支持的比例,保留分母,并纠正错误因果比较。

**必须保留的边界**

既不能因人数更多说 B 更好,也不能因没有因果识别说比例差异无法描述。

<a id="ex-18"></a>
## EX-18 · 负结果:没有显著差异,不等于等效

**输入事实**

情景研究报告两组差异检验:估计差异为 2 分,95% CI −1 到 5 分,p=0.18;未预设等效界值,也未报告等效性检验。目标是报告本次分析结果。

**冗余或错误稿**

结果没有显著性,可能说明研究没有什么价值。不过情况很复杂,也可能还需要更多研究,暂时似乎不宜得出任何结论。

**推荐改写**

本次差异检验未检出显著差异:估计差异为 2 分,95% CI −1 至 5 分,p=0.18。研究未预设等效界值,也未报告等效性检验,因此这些结果不构成两组等效的证据。

**为什么这样改**

用估计值、区间和可作出的判断替代空泛自我否定。

**必须保留的边界**

差异检验和等效性检验回答不同问题;跨过 0 的区间不能单独用来判断等效性。

<a id="ex-19"></a>
## EX-19 · 学习记录不等于熟练

**输入事实**

虚构学习者:本科生,每周有两小时;完成入门课前三节,能参考示例读取 CSV,但还不能独立清洗缺失值。近期目标是独立完成一个带缺失值的小表清洗。尚无研究项目或发表成果。

**冗余或错误稿**

我只是一个很差的小白,虽然已经精通数据分析,但学习因人而异,也没什么可说的。

**推荐改写**

我已完成三节入门课,能参考示例读取 CSV,下一步练习独立处理缺失值。每周两小时先用于完成一个小表清洗,再检查能否不看示例复现。

**为什么这样改**

用可观察能力、具体缺口与检查任务替代自贬和虚构熟练程度。

**必须保留的边界**

计划中的检查不是已经完成的成果;不能添加研究身份。

<a id="ex-20"></a>
## EX-20 · 经验、资源与下一步

**输入事实**

虚构材料:作者曾用带练习的资源 A 完成一个表格整理练习;资源 B 是理论讲义,作者未做对应练习。当前读者目标是练习表格整理,每周一小时。只知道这些资源特征,不知道价格、最新更新时间或总体效果。

**冗余或错误稿**

大家别骂我,这只是我的一点个人看法。A 和 B 都很好也都不好;A 肯定能让任何人一周精通。

**推荐改写**

如果目标是练习表格整理,可以先用带练习的 A。我曾用它完成一个整理练习;B 侧重理论讲义。下次一小时先做 A 的一个练习,再检查能否独立复现。价格和更新情况还需核实。

**为什么这样改**

按目标给具体建议,用真实个人经历限定依据,保留待核实信息。

**必须保留的边界**

一例经历不能推出所有人的学习效果,也不能凭空补价格或时效。

<a id="ex-21"></a>
## EX-21 · 代码评审要有触发条件

**输入事实**

虚构代码:def first(items): return items[0]。函数可能收到空列表;审阅者尚未运行测试。接口约定空列表时应返回 None。

**冗余或错误稿**

这个实现可能不是很优雅,建议谨慎考虑一些边界问题,我测试过全部通过。

**推荐改写**

当 items 为空列表时,items[0] 会抛出 IndexError,与空输入返回 None 的接口约定不符。建议先判断空列表并返回 None。尚未执行测试。

**为什么这样改**

指出可核对的触发条件和后果,删除模糊审美评价及虚构测试记录。

**必须保留的边界**

静态判断不能写成实际运行通过;若没有空输入约定,不能擅自决定返回值。

<a id="ex-22"></a>
## EX-22 · 按目标选择,完整报告性能代价

**输入事实**

情景选型:项目要求离线运行,优先降低延迟,可接受准确率下降不超过 1 个百分点。A、B 均已验证离线处理所需格式;同一机器和测试集下,A 准确率 90%、延迟 100 ms,B 准确率 89%、延迟 60 ms。未提供价格信息。

**冗余或错误稿**

两种工具各有优劣,存在很多不确定性,很难判断。B 的准确率还下降了,因此目前只能谨慎考虑,具体因人而异。

**推荐改写**

按当前目标选 B:两者都满足离线要求,B 将延迟从 100 ms 降至 60 ms,准确率由 90% 降至 89%,符合最多下降 1 个百分点的要求。

**为什么这样改**

把各有优劣变成同口径比较和有条件的选择,获益与代价同时写清。

**必须保留的边界**

同时保留准确率下降和延迟改善;价格留待核实。

<a id="ex-23"></a>
## EX-23 · 综述不能假装读过文献

**输入事实**

虚构文献笔记:文献甲在两个城市访谈,发现办理步骤不清楚;文献乙分析一个平台的办结记录,报告信息缺失与重复提交相关。检索仅限给定的两篇笔记,题目、作者、年份未提供。

**冗余或错误稿**

这个问题非常复杂,不同研究各有不同观点,可能需要辩证看待,目前似乎很难得出有价值的判断,还需要更多研究。

**推荐改写**

两份笔记均涉及办理信息问题:文献甲关注步骤理解,文献乙报告信息缺失与重复提交的关联。它们研究对象与方法不同,现有材料不足以比较问题的普遍程度。

**为什么这样改**

围绕给定文献作具体综合,用研究对象、发现与方法差异替代空泛平衡句。

**必须保留的边界**

不能编作者、年份或引用;两份笔记不足以支持领域全面共识。

<a id="ex-24"></a>
## EX-24 · 直接回答费用问题

**输入事实**

虚构产品规则:访客可看公开示例;导出功能属于付费方案;没有免费导出额度。用户问“我不付费能导出吗”。无需描述其他产品功能。

**冗余或错误稿**

我们非常重视不同用户的需求,具体情况可能有所不同,建议您自行探索。

**推荐改写**

不能,导出需要付费方案,没有免费导出额度。你可以先查看公开示例。

**为什么这样改**

明确回答已知规则,给真实可用选项,删回避式铺垫。

**必须保留的边界**

保留明确回答和真实可用的查看入口,按目标产品填入价格规则。

<a id="ex-25"></a>
## EX-25 · 催进度:明确约定与回复时间

**输入事实**

情景协作:陈同学已约定周五交设计图,今天是周四。负责人为了安排联调,需要陈同学今天 17:00 前确认当前进度,以及周五是否能按时交付。没有材料表明对方已延期。

**冗余或错误稿**

不好意思又打扰了,知道你可能比较忙,图的事情或许方便的时候再看看,不着急,给你添麻烦了。

**推荐改写**

陈同学,按约定请周五交设计图。为安排联调,请今天 17:00 前确认当前进度,以及周五能否按时交付。谢谢。

**为什么这样改**

保留正常礼貌,明确既有交付约定和本次需要的回复,删除与实际时间要求矛盾的“不着急”。

**必须保留的边界**

今天 17:00 是回复时间,周五是交图时间;不能写成对方已经延期。
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall