体验报告编写指南

适用于「探索者」赛道 — 不写代码，也能拿奖。

作品类型

类型	评分重点	预计用时
上手体验报告	问题清单 + 改进建议	1-2 小时
竞品对比分析	深度和独到见解	2-3 小时
Prompt 工程	Persona 模板的实用性	1-2 小时
使用教程	清晰度和可操作性	1-2 小时
场景方案	完整性和创新性	2-3 小时

体验报告模板

README.md 基本结构

# 云雀 Agent 体验报告

> 作者：你的名字  
> 日期：2026-04-xx  
> 测试环境：Windows 11 / 8GB RAM

## 一、安装体验

### 安装过程
- 下载用时：xx 分钟
- 安装步骤：描述你的安装过程
- 遇到的问题：（如有）

### 首次启动
- 启动时间：约 x 秒
- 首屏印象：描述你看到了什么

## 二、功能测试

### 基础对话
测试了以下场景：
1. 简单问答 — 结果：✅/❌
2. 多轮对话 — 结果：✅/❌
3. 代码生成 — 结果：✅/❌

（附截图）

### Skill 体验
- 尝试了哪些内置 Skill
- 效果如何
- 是否符合预期

### 其他功能
- 记忆系统
- 插件系统
- ...

## 三、发现的问题

| 编号 | 问题描述 | 严重程度 | 复现步骤 | 是否已提 Issue |
|------|---------|---------|---------|--------------|
| 1 | ... | 高/中/低 | ... | Issue #xx |
| 2 | ... | ... | ... | ... |

## 四、改进建议

### 建议 1：[标题]
- 现状：目前是怎样的
- 问题：为什么不好
- 建议：可以怎么改

### 建议 2：[标题]
...

## 五、总结评价

### 优点
- ...

### 不足
- ...

### 总体评分
| 维度 | 评分 (1-5) |
|------|-----------|
| 安装便捷性 | ⭐⭐⭐⭐ |
| 功能完整度 | ⭐⭐⭐ |
| 交互体验 | ⭐⭐⭐⭐ |
| 文档质量 | ⭐⭐⭐ |

竞品对比模板

# 云雀 Agent vs [竞品名称] 对比分析

## 对比维度

选择 1-2 个维度深入分析：

### 维度一：[例如：Skill/插件 生态]

| 特性 | 云雀 Agent | [竞品] |
|------|-----------|--------|
| Skill 创建方式 | ... | ... |
| 是否支持本地运行 | ✅ | ❌ |
| 数据隐私 | ... | ... |
| ... | ... | ... |

#### 分析
（你的见解，不要只列表，要有分析和观点）

### 维度二：[例如：部署与上手难度]
...

## 结论
云雀的优势在于...，[竞品]的优势在于...
对于 [某类用户]，推荐...

高分技巧

1. 截图和录屏

• 每个功能测试都附上截图
• 关键操作可以录 GIF（推荐 ScreenToGif）
• 截图放在仓库的 images/ 目录下

2. 提交 Issue（加分 15%）

发现了 Bug 或有改进建议？提交到主仓 Issue：

• 标题清晰：[Bug] 安装后首次启动白屏 或 [建议] 对话页面增加导出功能
• 描述详细：复现步骤、期望行为、实际行为
• 附上截图

3. 排版美观

• 使用 Markdown 表格整理数据
• 标题层级清晰（h1 → h2 → h3）
• 适当使用粗体、列表、引用
• 代码块标注语言

4. 有自己的观点

不要只写"好"或"不好"，要说：

• 为什么好/不好
• 和什么相比
• 怎么改会更好

提交方式

1. 在比赛组织下创建新仓库，命名：yunque-exploration-你的名字
2. 把 README.md 和截图/附件都提交进去
3. 如果发现了 Bug，同时在 yunque-agent 主仓提 Issue

常见问题

Q: 报告写多长合适？ A: 1500-3000 字为佳。重点是质量不是数量。

Q: 可以写英文吗？ A: 可以，但评审以中文为主。

Q: 需要测试所有功能吗？ A: 不需要。挑 2-3 个功能深入测试，比蜻蜓点水全都试一遍更好。