rrrrrredy/research-toolkit / plugins/research-toolkit
research-toolkit
FlaggedUse for source-backed long-form research and writing in English or Chinese across fields, including revisions and continuation. Understand requirements, develop analysis through substantive research collaboration, and deliver a complete report after independent review, audit and acceptance.
references/writing-style.zh-CN.md
View on GitHub# 写作风格
[English](writing-style.md) | [简体中文](writing-style.zh-CN.md)
起草、重写或定稿前阅读本页。
需要具体判断如何展开、删减或修订论证时,按需阅读[取舍示范](writing-style.zh-CN.md#研究段落的取舍示范)。
<!-- method:writing -->
## 叙述立场
按任务约定的读者、文体和风格写作,陈述已知事实,直接解释判断、机制、比较和影响。保留来源归属,在受影响的判断旁说明具体成立条件或尚未解决的证据问题,用这些内容替代反复泛泛的谨慎表态。用户要求方法说明、来源范围或操作指南时,这些内容也是答案的一部分;是否删去过程叙述,见[去过程化表达](#去过程化表达)。
## 文章结构
按读者的问题组织正文,保留任务要求的覆盖与格式,不照搬资料收集顺序。组织长报告、连接各节论证或减少重复介绍时,按需读取[组稿与整篇示范](research-workflow.zh-CN.md#9-组稿);段落的表达与删改继续使用本页方法。
## 篇幅与决策用途
起草前先为必答问题分配篇幅。任务有篇幅限制或交付需要篇幅统计时,交付前按约定口径统计实际正文(英文词数或中文字数,标题与参考资料按约定处理),在交付说明或已有记录中注明结果与口径,无需另建 checklist。需要计数但未约定口径时,采用合理口径并说明。优先压缩重复背景和通用提醒,在约定篇幅内保留并展开必要分析。
做局部修订时,保留未受影响的判断、成立条件、来源归属和可用链接。新主张限于约定范围和已确认问题所需的内容。修改后超出篇幅时,先删可选细节和重复表述。重新测量实际稿件,核对各章节受改动影响的结论。
研究需要支持决策时,明确建议、理由、下一步及改变决策的条件。区分实测结果与拟议试点条件。拟议数字目标须说明风险、基线或约定服务要求等依据;缺乏依据时说明触发条件及校准方法。检查目标是否会鼓励隐藏失败或阻断必要转接,例如限制转人工比例可能妨碍用户及时获得人工服务。
任务要求可执行计划时,让第一步可以落地:交代起始范围、负责角色、实际时间或资源假设,以及扩大、调整或停止工作的观察依据。建议采用的起始数值须标明是建议。只采用与当前决策有关的细节,不将它们变成通用清单,也不要求新增外部参与者。
长报告内的摘要或局部论证,应在分配给该部分的篇幅中合并相关回答。表格、背景与附录按整篇报告的需要安排,不在每个单元重复铺设。将推荐与全部当前硬约束逐项核对,不能默默用性能交换预算上限,也不能把增长预测当成已经存在的要求。结论须保留来源的时间、样本和测量条件。缺少测量时保留未知;差异或不存在的判断须有相应观察依据。约定格式有单独交付说明时,将生产状态放在那里;实质证据限制仍留在正文中。
## 删冗余,保留理解所需关系
删去没有推进回答的重复概括、背景和套话;保留读者理解论证所需的主体、动作、条件、否定、因果和转折。术语的再次出现、对不同对象的同维度比较、结论对关键理由的简要回扣,不因措辞相似就算冗余。用具体主体和动作展开说明,解释必要术语在当前问题中的作用,不把推理压成抽象名词串。需要补足关系时可以写得更充分;改写不能丢掉事实、来源归属或对应引用。
改写前:
> 来源变化不直接等同于结论失效,应完成影响范围定位与证据充分性复核。
改写后:
> 先找出变化的事实及依赖它们的结论,再用更新后的证据核对这些结论。依据与推理仍然成立的判断继续保留。
改写展开了动作顺序和判断条件,仍保留原来的证据边界。
将正文内容压缩成摘要、表格或结论时,关键事实的含义保持不变。数字应连同统计对象、指标定义和影响判断的范围一起表达;简写不能把缺失率改成完整率,或把样本内的比例变成全部任务的比例。来源的栏目名与具体说明容易混淆时,依据完整说明转述,不只沿用栏目名。
例([已归档的合成试点材料](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-21-external-batches/tasks/ai-agent-workforce-fte-roi-bar-en-20261018/sources/S4.md#L7),不是现实企业的统计):栏目名是“完整度”,具体说明却是 62% 的人工修改缺少原因码。[原稿与修订记录](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/repairs/2026-10-21-source-polarity/README.zh-CN.md)保留了同一稿中正确转述与错误简写并存的情况。
错误简写:
> 原因码完整度为 62%。
保留原意的写法,可按所在位置选用:
| 位置 | 表述示范 |
| --- | --- |
| 正文 | 该试点中,62% 的人工修改缺少原因码。 |
| 表格 | 人工修改原因码缺失率:62%(该试点)。 |
| 结论 | 该试点有 62% 的人工修改未记录原因。计算任务层面的人工修改率需以全部任务为分母;估计岗位替代还需工作量与用工变化的证据。 |
<!-- /method:writing -->
## 研究段落的取舍示范
需要决定补什么、删什么或改到哪里时,选读相关示范。它们复用公开归档中的合成材料,不是现实企业调查;原稿和历史记录保持不变。前两组是据原稿与另存修订稿整理的教学改写,第三组的后续要求为本次构造。示范不是唯一答案:措辞和结构可以不同,但要回答当前问题、说明证据如何支持判断;作者想表达的结论也须接受证据检验。
### 补充分析:停机下降,为什么还不能决定多年预付?
**问题与材料。** 制造企业要判断预测性维护是否值得多年预付。[90 天复盘](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/iIoT-predictive-maintenance-arr-zh-20261016/sources/S3.md)记录停机从 1,840 降至 1,510 分钟,同期排产负荷下降 6%、备件策略改变;[采购纪要](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/iIoT-predictive-maintenance-arr-zh-20261016/sources/S2.md)另有非瓶颈车间接受较弱条款的反例。
**原稿的不足。** [原稿第 3 节](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/iIoT-predictive-maintenance-arr-zh-20261016/final.md)已经提醒不能全部归因,却很快跳到“停机 ROI 只能当营销,不能当合同对价”,没有解释改善幅度怎样连接采购价值,也容易把仍有用的观察一并否定。[另存修订稿第 4—6 节](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/repairs/2026-10-19-reader-edit/reports/iIoT-predictive-maintenance-arr-zh-20261016.md)补足了这层分析。
**正文改写:**
> 停机减少 330 分钟,约为对照期的 17.9%,值得继续追查产品贡献。同期排产负荷下降 6%,备件策略也发生变化。两个百分比衡量的对象不同,应结合具体故障、负荷与备件变化评估模型贡献,而非直接相减或将全部降幅计入模型收益。采购价值还取决于避免损失的每分钟金额、人工处置成本与订阅费之间的关系。另一非瓶颈车间接受弱条款,支持考虑在这类场景限定范围试用。对瓶颈产线,应继续评估,待损失测算、漏报责任与预付款退还约定足以支持这项承诺时,再决定多年预付。
**取舍理由。** 保留下降幅度与反例,补上“观察变化—归因—经济价值—合同选择”之间缺失的关系。这里需要增加解释;仅补一句“样本有限”或把结论改得更谨慎,都没有回答采购问题。
### 删减内容:什么材料决定一份 RFQ 能怎样回答?
**问题与材料。** 制造商要用排放因子库回答客户询价。[合成产品手册](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/scope3-factor-rfq-evidence-en-20261016/sources/S1.md)宣称含 12,000 多个因子、曾用于 40 份无人质疑的 RFQ;实际是行业平均或支出估算,付费档仅为 30% 的 SKU 提供区间,也不提供第三方保证。[顾问摘录](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/scope3-factor-rfq-evidence-en-20261016/sources/S4.md)则称部分买方接受标明用途的筛选估计。
**原稿的不足。** [原稿](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-19-external-batches/tasks/scope3-factor-rfq-evidence-en-20261016/final.md)已有有用的分层建议,却在结尾反复解释“合格长文”与证据纪律。这些提醒不能帮助读者判断当前因子是否适用。[修订稿第 1、3、6 节](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/repairs/2026-10-19-reader-edit/reports/scope3-factor-rfq-evidence-en-20261016.md)把篇幅用于买方问题与证据的匹配。
**正文改写:**
> 按买方用途选择 RFQ 的回答方式。初步筛选可在买方接受的前提下,使用因子库中的行业平均或支出估计,并标明用途。比较特定供应商产品时,需要解释所选因子为何适用于该产品。付费档为 30% 的 SKU 提供区间,应核对本次产品是否在内,并保留估计方法与适用范围。因子库不提供第三方保证;客户要求保证结论时,须取得相应保证再提交。接受已标明用途的筛选估计的买方,则可以在这一较窄用途下使用它。
**取舍理由。** 目录规模与“无人质疑”描述产品宣称的范围和既往使用。本次决策取决于当前产品、买方用途与保证要求,因此段落展开这些关系,删去重复的产品背景和写作说教。付费档覆盖范围和筛选用途的反例继续保留,因为它们改变具体建议。删减让必要分析有空间,不以最短为目标。
### 局部修订:需求变了,哪些判断跟着变?
**原有问题与材料。** [归档 Maple 任务](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/diagnostics/2026-10-13-targeted-recheck/judges/maple-storage-en/packet.json)为虚构存储采购:首年总预算 10 单位、恢复不超过 4 小时、数据留在本地、当前需求 12 TB。A 为 11 单位/2 小时/24 TB,B 为 8/5/24,C 为 8/3/14;三者均为本地部署。下一年增加 4 TB 当时只是预测,C 扩容价格与恢复时间未知。
**原文与变化。** [归档正文](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/repairs/2026-10-13-astra/maple-storage-en.md)据此推荐 C,原判断符合当时要求。本示范新增一条**构造要求**:预算已批准提高到 11,16 TB 成为现在必须满足的容量,其余条件不变。此时继续推荐 C 会沿用失效前提;把所有分析改成“资料不足,重新调研”,又会丢掉仍然成立的比较。
**正文改写:**
> 按更新后的 11 单位预算和 16 TB 当前容量要求,A 以 11 单位总成本、2 小时恢复和 24 TB 容量满足条件。B 的 5 小时恢复仍超过上限;C 的 14 TB 不足,重新评估它需要至少达到 16 TB、价格和恢复时间已明确的扩容方案。三者均为本地部署。可靠性和运维劳动在现有证据中仍未确定。预算与容量要求的变化使推荐改为 A,材料中的成本、恢复时间和容量数值保持不变。
**取舍理由。** 修改推荐及其预算、容量理由,保留 B 的恢复限制、本地部署与未知项。是否改判取决于新输入改变了哪项前提,不取决于更新幅度或是否出现了新文件;真实任务中的补充要求与证据须来自实际输入,不能仿造本例。
<!-- method:language-style -->
## 中文长文
- 标题清楚、直接。
- 核心洞察尽量靠前;开篇信息密集时可以编号。
- 只保留确有必要的行业英文术语,消除翻译腔。
- 删去与题目无关的制作叙述;内部来源编号只在任务要求呈现或解释时保留。
- 遵守任务要求的引用形式;仅在要求或确有帮助且任务允许时列参考资料,明确不设清单时遵守该要求。保留理解或核验答案所需的来源归属与定位。
## 英文长文
使用具体名词和主动动词,删去咨询报告式套话。说明事实为什么会改变论证;限定条件简短、明确。每段承担具体作用,避免逐条转述来源。
## 去过程化表达
根据一句话在当前答案中的作用决定删、改或保留,不按词语或句式命中删文:
- 只交代收集、记录或审核动作,没有帮助读者理解答案的,删除。任务明确要求这些信息时,按约定呈现。
- “材料显示”等表述过于笼统时,说明是哪份材料、支持什么判断;保留“报告称”“估计”等必要归属,不能改写成已经独立确认的事实。“用户提供”若限定了材料范围,也不应直接删去。
- 比较、并列、转折、标题和限定语有助于读者辨别方案、理解推理或定位内容时,保留;只有重复结论而没有增加理由、区别或用途的部分才需要压缩。语言特征出现得多,不等于文章质量差。
例如,[已归档的合成冷链简报](https://github.com/rrrrrredy/research-toolkit/blob/main/evals/studies/2026-10-27-research-writing-choices/runs/cold-chain-revision/after/output.md)说明独立试验的环境、起始温度和适用工况,这是比较依据;“全天客服不等于车辆可即时调度”区分了服务宣传与实际保障。两处都应保留。相反,“同时满足这些要求”把尚未确认的下周交付时间也概括了进去,应改为明确满足的容量、温控和预算条件,并说明交付日期仍待确认。修改的理由是判断范围不准确,不是句式像 AI。
## 参考资料
公开文章的参考资料应便于阅读,可列类别、机构或来源类型、标题。内部编号、本地路径、访问状态或审核等级,只在任务要求呈现或解释时保留。
按交付格式检查引用。导出 Markdown 或文档时,将聊天或工具专用引用标记替换为来源记录中的对应标题、网址及有用定位;原会话中有效的标记不等于可移植的参考资料。核对目标,不猜测网址;任务本身在解释标记语法时保留相应字面文本。
常见类别:
- 官网、申报文件、官方博客、文档与报告。
- 论文、技术报告、数据集与代码仓库。
- 访谈、演讲、播客与公开讲话。
- 行业报告、市场数据、价格与财务资料。
- 媒体报道与长篇评论。
- 用户、开发者与社区讨论。
- 批评、失败、争议与反证。
<!-- /method:language-style -->
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |