rd-writing git:20260726.db4ec36A

Immutable. This exact content never changes and is served at /api/v1/blob/d4910d1545423bba.

---
name: rd-writing
description: >-
  编写有来源支撑的技术文章、白皮书、研究或事实核查报告、决策简报和其他专业解释性文档。
  当已核实证据需要面向真实受众和发布/决策目的组织成文，同时保留不确定性、反方论证和
  追踪关系时使用。不用于 PRD、架构选型、详细设计、标准制定或独立评审。
---

# rd-writing

将已核实材料转化为面向受众的专业文档，同时保持主张、逻辑和证据可审计。

## 交付物

- 技术文章、解释性文章或技术白皮书
- 研究综述或事实核查报告
- 决策简报、立场文件或证据导向的建议备忘录
- 重要时附主张—来源映射和未解决证据说明

## 选择输出模式

只读取目标任务需要的参考文件：

| 模式 | 目标对象 | 参考文件 |
|------|----------|----------|
| 技术文章 | 技术文章、解释性文章、技术白皮书 | [technical-article.md](references/technical-article.md) |
| 证据报告 | 研究综述、事实核查报告、证据评述 | [evidence-report.md](references/evidence-report.md) |
| 决策简报 | 决策备忘录、立场文件、高管技术简报 | [decision-brief.md](references/decision-brief.md) |

## 通用流程

### 1. 固定写作契约

- 确认受众、决策或发布目的、范围、体裁、篇幅、语气、日期边界和引用格式
- 识别已提供来源、需要当前核实的主张，以及编辑或组织约束
- 保留既有术语、名称、日期、引语、编号和追踪关系
- 用户给出期望结论时，将其视为待检验命题，而非需要维护的事实

### 2. 建立主张结构

- 明确中心问题和候选结论
- 建立主张层级：中心主张、支持主张、证据、反方主张、限制和含义
- 区分事实、估算、推断、预测、观点和价值判断
- 删除与文档目的无关或缺乏证据的主张

### 3. 先核实再起草

- 先检查用户提供材料和项目来源；易变、争议、外部或影响决策的主张使用 `rd-research`
- 重要时核实时间线、版本、法域、单位、分母、引语上下文和来源所有者
- 记录冲突和证据缺口；不得让流畅文字掩盖不确定性

### 4. 面向受众起草

- 除非体裁另有要求，先给答案或决策意义
- 使用最小充分结构，只在受众知识需要时解释专业术语
- 公平呈现最强重大反方论证，再进行回应
- 证据就近支持主张，并区分来源事实与作者分析
- 只有真实比较才使用表格，只有结构、流程或因果需要澄清时才使用图示

### 5. 编辑与核验

- 检查事实准确性、引用支持关系、时间顺序、因果逻辑、内部一致性、术语和数值单位
- 删除宣传式、口号式、模板式、重复和无依据表述
- 确认结论不超出证据，且局限具体而非套话
- 高影响或争议文档保留主张—来源映射

## 工具选择

- 外部检索前先检查本地文档和仓库材料
- 使用 `rd-research` 建立或更新证据包，不在起草过程中重复深度研究流程
- 内容稳定后，使用文档格式 Skill 生成 `.docx`、PDF、演示文稿或表格产物
- 只有事实和论证完整后才使用语言润色 Skill

## 质量门禁

- [ ] 受众、目的、范围、模式和日期边界明确
- [ ] 中心与支持主张有证据支撑，逻辑连接成立
- [ ] 事实、推断、估算、预测、观点和示例可区分
- [ ] 公平呈现最强反方论证和重大限制
- [ ] 引用支持相邻主张，易变事实带有时间/版本背景
- [ ] 语气专业具体，无宣传或模板填充
- [ ] 最终结论未超出证据边界

## 不做

- 实际目标为结构化交付物时，使用 `rd-requirement`、`rd-solution`、`rd-design` 或 `rd-specification`
- 主要任务是对现有文档给出独立结论时，使用 `rd-review`
- 不编造来源、引语、数据、被描述为真实的示例、日期或因果确定性
- 不通过隐瞒反证、不确定性或利益冲突来增强说服力