sa-writing

Files (2)

• SKILL.md
• common-argument-flaws.md

SKILL.md (first lines)

# 论证驱动写作 (Argument-Driven Writing, ADW)

## 概述

先写出缺乏支持的主张（检验失败）。看它缺乏证据。撰写最简内容以提供支持。

**核心原则：** 如果你没有先确认主张缺乏支持，你就不知道你是否在论证正确的东西。

**违反规则的字面意思就是违反学术严谨的精神。**

## 铁律

```
没有先行的待证主张，就不写正文
(NO PRODUCTION TEXT WITHOUT A UNSUPPORTED CLAIM FIRST)
```

在提出主张之前写正文？删除它。重新开始。

**无例外：**
- 不要保留它作为“参考”
- 不要在寻找证据时“调整”它
- 不要看它
- 删除意味着删除

从主张开始重新撰写。句号。

## 主张-证据-完善 (Claim-Evidence-Refine)

```dot
digraph adw_cycle {
    rankdir=LR;
    claim [label="主张 (CLAIM)\n提出待证观点", shape=box, style=filled, fillcolor="#ffcccc"];
    verify_claim [label="验证缺乏支持\n(Verify Fail)", shape=diamond];
    evidence [label="证据 (EVIDENCE)\n最简论证", shape=box, style=filled, fillcolor="#ccffcc"];
    verify_evidence [label="验证论证成立\n(Verify Pass)", shape=diamond];
    refine [label="完善 (REFINE)\n润色行文", shape=box, style=filled, fillcolor="#ccccff"];
    next [label="下一个", shape=ellipse];

    claim -> verify_claim;
    verify_claim -> evidence [label="是"];
    verify_claim -> claim [label="验证错误"];
    evidence -> verify_evidence;
    verify_evidence -> refine [label="是"];
    verify_evidence -> evidence [label="否"];
    refine -> verify_evidence [label="保持成立"];
    verify_evidence -> next;
    next -> claim;
}
```

### 主张 (CLAIM) - 提出待证观点

写出一个你想要论证但目前文中尚未建立的观点。

<Good>
```markdown
<!-- 待证主张 -->
本节将论证：算法 A 在处理稀疏数据时优于算法 B。
现状检查：当前草稿中未包含相关对比数据或理论推导。
```
清晰的目标，测试真实的行为，单一焦点
</Good>

<Bad>
```markdown
<!-- 待证主张 -->
写关于算法 A 的东西。
```
模糊的目标，没有明确的验证标准
</Bad>

### 验证缺乏支持 (Verify CLAIM) - 看它失败

**强制性。绝不跳过。**

阅读当前草稿。

确认：
- 确实没有支持该主张的证据或论述
- 缺乏支持是因为还没写（而不是因为写错了地方）

**如果主张已成立？** 你在做重复工作。修改主张。

### 证据 (EVIDENCE) - 最简论证

撰写最简单的段落来支持该主张。

<Good>
```markdown
根据表 3 的实验结果，在稀疏度为 90% 的数据集上，算法 A 的收敛速度比算法 B 快 15%。这归因于算法 A 采用了更高效的索引机制...
```
足以支持主张即可
</Good>

<Bad>
```markdown
算法 A 是一种伟大的算法，由 Smith 等人于 2020 年提出。它不仅快，而且... [两页无关背景]
```
过度撰写，偏离核心主张
</Bad>

不要添加额外的论点，不要重写其他部分，或者“改进”超出主张范围的内容。

### 验证论证成立 (Verify EVIDENCE) - 看它通过

**强制性。**

阅读新写的段落。

确认：
- 主张现在得到了充分支持
- 逻辑连贯
- 没有引入新的逻辑漏洞

### 完善 (REFINE) - 润色

仅在验证通过后：
- 优化措辞

From kun4ai/superpowers-academic, MIT.

More from kun4ai/superpowers-academic