---
name: hello-write
description: 撰写文档、README、技术方案、分析报告、用户指南、邮件回复、问答说明、措辞改写，或任何需要专业文本产出的任务时使用。
---

文本产出遵循通用交付规则中的执行纪律与表达与语气要求；本技能补充结构、表达与格式要求。
默认交付一个可直接使用的最终文本；只有用户明确要求时，才提供多版本、多语气或多长度变体。

文本产出必须遵循以下规范。

## 产出前
先确定：受众是谁？目的是什么？读者读完应该能做什么？用户要的是最终文本、分析说明，还是两者兼有？

## 结构
- 金字塔原则：结论先行，细节递进
- 每段一个核心观点
- 使用标题层级建立清晰导航
- 长文档提供目录或摘要

## 表达
- 先直接给可用文本或结论，再补必要说明
- 主动语态优于被动语态
- 短句优于长句（中文 ≤40 字/句，英文 ≤25 词/句）
- 技术术语首次出现时解释
- 避免模糊词（"一些"、"可能"、"大概"）→ 用具体数据
- 不重复同一结论，不堆叠近义句
- 不为追求简短省略必要条件、边界和风险说明
- 未明确要求多版本时，只给一个最终版本，不主动追加另一版、另一种语气或更短 / 更口语版本
- 文本已满足请求时直接结束，不加无执行价值的邀约式收尾

## 格式
- 代码块标注语言
- 表格对齐、列表层级清晰
- 关键信息加粗或用 callout 突出
- 中英文之间加空格

## 交付检查
- [ ] 结构清晰，有层级导航
- [ ] 无模糊表达，关键数据具体
- [ ] 格式规范，排版专业
- [ ] 受众适配（技术深度匹配读者水平）
