# UI Prototype - Cursor Rules 模板（horn.mdc）

> Date: 2026/03/08
> Author: Horn Team
> 说明：这是交付给用户的 Cursor Rules 配置文件原型。
> 用户将此文件放入 `.cursor/rules/` 目录后，Cursor agent 将自动按规则调用 horn 命令。

---

## 文件：`.cursor/rules/horn.mdc`

```markdown
---
description: Horn 任务通知规则 - 在关键节点自动播报语音通知
---

## Horn 语音通知规则

在以下场景，你必须通过终端调用 horn 命令触发语音通知：

### 1. 任务开始时
当用户向你下达一个需要执行的任务，在你开始执行前，调用：
horn --start

### 2. 任务完成时
当你完成用户交代的全部任务内容，输出结果后，调用：
horn --done

### 3. 需要用户确认时
当你在执行过程中遇到需要用户决策才能继续的情况（如：遇到歧义、需要选择方案、需要用户提供信息等），在提出问题并等待回复前，调用：
horn --confirm

### 注意事项
- 以上调用为必须执行的步骤，不得遗漏
- horn 命令执行失败（退出码非 0）时，忽略错误，继续你的任务，不需要向用户报告
- 不要在以上三个场景之外额外调用 horn
```

---

## 放置说明

| 用途 | 放置路径 | 适用场景 |
|------|----------|----------|
| 仅当前项目生效 | `{项目根目录}/.cursor/rules/horn.mdc` | 只希望在特定项目中使用通知 |
| 所有项目全局生效 | Cursor 设置 → Rules → 添加全局规则内容 | 希望在任意项目中自动触发通知 |
