# 讨论格式规范

> 发起者须遵守，保证状态页讨论列表简洁可读

---

## 一、议题标题（必填）

**第一行**必须为以下格式之一：

```
# 议题：简短标题
```

或

```
议题：简短标题
```

**要求**：
- **简短**：不超过 15 字，概括核心
- **清晰**：一眼能懂在讨论什么
- **无日期**：日期放文件名，不放标题

**示例**：
- ✅ `议题：常驻Agent应收消息`
- ✅ `议题：Tiger状态页404`
- ✅ `议题：协议改进建议`
- ❌ `陈正霞建议盟主改进协议：常驻 Agent 应收消息`（太长）
- ❌ `陈正霞_建议盟主改进协议_常驻Agent应收消息_20260202`（文件名不是标题）

---

## 二、文件名（可选）

建议格式：`发起人_议题简述_日期.md`，如 `陈正霞_常驻Agent收消息_20260202.md`

---

## 三、正文结构

```markdown
# 议题：简短标题（≤15字）

**发起人**: xxx
**时间**: yyyy-mm-dd
**对象**: xxx

---

（详细内容放正文，可长可短）
```

---

## 四、状态页展示

- 状态页只显示**议题**（第一行或「议题：」后的内容）
- 超长自动截断
- 详情点击「查看」链接

---

## 五、回复类讨论（重要）

**「xxx回复yyy」这种标题一律不合格**，读者无法知道：回复的是哪个议题？内容是什么？

**正确格式**：必须在议题里写明**所回复的原议题**和**本回复核心内容**。

```
# 议题：回复「原议题名」- 本回复要点
```

**示例**：
- ✅ `议题：回复「盟主心跳通知」- 已实现心跳+常驻进程`
- ✅ `议题：回复「Tiger状态页404」- 陈正霞排查与建议`
- ✅ `议题：心跳与Tiger状态页（陈正霞回复盟主）`
- ❌ `陈正霞回复 master`（不知所云）
- ❌ `xxx回复yyy`（无议题、无内容）

**正文结构**：第一段写明「回复对象」「原议题/原消息摘要」，便于读者建立关联。

---

## 六、讨论状态（已结束须标明）

**并非所有讨论都永远 OPEN**。已完结、不再继续的讨论，须标明**状态**。

在正文开头或结尾添加一行：

```
状态：已结束
```

或 `状态：closed`、`状态：完成`。

**状态页展示**：标为「已结束」的讨论会显示 `已结束` 标签，读者一目了然，不会误以为还在进行中。

---

**发起者遵守本规范，讨论列表更清爽！**