# AI Agent 场景文档 · 追加规则提示词
> **文档位置**: `D:\baidu-pan\agent-scenes.html`
> **规则**: 追加模式（APPEND-ONLY）· 严禁覆盖已有内容
> **创建时间**: 2026-07-21
> **维护者**: 所有 AI Agent（DuMate / QClaw / Marvis / Hermes / 其他）
---
## ⚠️ 永久约束（违反即事故）
1. **绝对禁止覆盖** `agent-scenes.html` 的已有内容
2. **只能追加**新场景到文件末尾的 `` 之后
3. **追加前必须先读取文件**，找到最后一个 `` 的位置
4. **场景编号递增**：当前最后一个场景编号 + 1
5. **不修改已有场景**的任何内容（包括 CSS、导航、Hero 等）
> 历史教训：此文档已被不同 AI Agent 覆盖过两次，导致之前记录的场景永久丢失且无法恢复。
> 从 Scene 03 起，所有 Agent 必须严格遵守本追加规则。
---
## ⚡ 第 0 步：识别本会话包含几个场景（最重要）
**一个会话可能包含多个独立的 AI Agent 使用场景**，每个都值得单独记录为一个 Scene。
### 识别方法
回顾本次会话的全过程，寻找满足以下任一条件的片段：
- 用户提出了一个**新的、独立的任务目标**（不同于之前的目标）
- Agent 切换了**完全不同的能力域**（如从文件管理 → 网页研究 → 文档生成）
- 发生了一个**独立的、有教学价值的决策或互动**（如用户纠偏、策略转变、意外发现）
- 产出了一个**独立的交付物**（如一份分析报告、一个工具脚本、一套方案）
### 拆分 vs 合并
| 情况 | 处理方式 | 示例 |
|------|----------|------|
| 同一任务的不同阶段，逻辑连贯 | **合并为一个 Scene**，用工作流步骤体现各阶段 | 百度网盘整理：API封装→扫描→去重→删除，是同一任务的7个阶段 → 1个Scene |
| 不同任务目标，能力域不同 | **拆分为多个 Scene**，各自独立记录 | 同一会话中先做了网盘整理，又做了战略分析 → 2个Scene |
| 同一任务中发生重大策略转变 | **可拆分为两个 Scene**，前一个记录原策略，后一个记录转变后的策略和原因 | 从"删除副本"转变为"合并目录"策略 → 可拆2个Scene，也可合1个Scene但需突出转变 |
| 一个独立的有价值的小任务 | **单独一个 Scene**，即使篇幅短也没关系 | 为网盘去重生成交互式HTML让用户选择 → 可独立1个Scene |
### 识别后
1. 在回复中列出你识别出的所有场景，例如："本次会话包含 3 个场景：S4·xxx、S5·xxx、S6·xxx"
2. 逐个按下面的追加步骤执行
3. **每个场景独立编号**，依次追加
---
## 追加操作步骤
### 第 1 步：读取现有文件
```
Read D:\baidu-pan\agent-scenes.html
```
确认：
- 当前文件有多少个场景（搜索 ``，`newString` 在其后插入新场景内容 + 新的结束标记。
**追加一个场景**：
```
oldString: ""
newString: "\n\n\n\n"
```
**一次追加多个场景**（如3个）：
```
oldString: ""
newString: "\n\n\n\n\n\n\n\n\n\n\n\n"
```
**绝对不能**：
- 用 `write` 工具覆盖整个文件
- 用 `edit` 替换已有场景的内容
- 修改 `` 中的 CSS（新场景复用已有样式类）
### 第 4 步：更新场景索引
在文件顶部的场景索引区域（搜索 `📍 场景索引`），为每个新场景追加一行链接：
```html
S4 · 场景名称
S5 · 场景名称
```
### 第 5 步：更新 index.html（可选）
在 `D:\hermes-html\index.html` 的 "AI Agent 工作场景" 版块，更新场景卡片描述或追加新卡片。
---
## 新场景模板
每个场景必须包含以下结构：
```html
场景标题
一句话描述这个场景做了什么。
标签1
标签2
标签3
```
---
## 可用的 CSS 类（复用已有样式，不要新增）
| 类名 | 用途 |
|------|------|
| `.hero` | 场景顶部大标题区 |
| `.hero h1` | 主标题（可用渐变色） |
| `.hero-tags` / `.hero-tag` | 标签云 |
| `.container` | 内容主容器（max-width:960px） |
| `.section` | 一个完整章节 |
| `.section-header` / `.section-icon` / `.section-title` | 章节标题行 |
| `.section-desc` | 章节描述 |
| `.card` / `.card-title` | 内容卡片 |
| `.tag` / `.tag-correct` / `.tag-error` / `.tag-doubt` / `.tag-blue` / `.tag-purple` / `.tag-cyan` | 标签 |
| `.info-table` | 信息表格 |
| `.flow` / `.flow-step` / `.flow-step-num` / `.flow-step-title` / `.flow-step-desc` | 流程步骤 |
| `.compare-grid` / `.compare-card` | 对比卡片网格 |
| `.quote-block` | 引言块（可改 border-left-color 和 background） |
| `.item-list` / `.item-bullet` | 列表 |
| `.hl-green` / `.hl-red` / `.hl-amber` / `.hl-blue` | 高亮文字 |
| `.footer` / `.footer-brand` / `.footer-text` | 页脚 |
| `.dumate-badge` | DuMate 标识徽章 |
---
## 场景内容规范
每个场景应包含：
1. **场景概述**：用户背景、痛点、任务定义
2. **Agent 工作流**：分步骤展示 Agent 做了什么（流程图式）
3. **关键决策与用户互动**：哪些地方 AI 根据用户反馈调整了策略
4. **成果数据**：具体数字、表格、对比
5. **Agent 价值总结**：一段话总结核心价值
**内容原则**：
- 用真实数据，不用占位符
- 用用户原话引用关键洞察
- 展示 AI 的思考过程和决策逻辑，而不只是结果
- 突出"用户反馈如何改变了 AI 的工作方式"
- 标注 Agent 名称标签（DuMate / QClaw / Marvis / Hermes 等）
---
## 完整提示词（复制此段发给其他 AI Agent）
以下是你复制给其他 AI Agent 的完整指令，直接粘贴即可：
```
你的任务完成后，需要将本次对话中涉及的 AI Agent 使用场景记录到场景文档中。
⚠️ 重要：一个会话可能包含多个独立的场景，需要逐一识别和记录。
## 场景识别规则
回顾本次会话全过程，识别所有值得记录的场景：
- 用户提出了一个独立的任务目标 → 一个场景
- Agent 切换了完全不同的能力域 → 一个场景
- 发生了一个有教学价值的决策或互动 → 可独立一个场景
- 产出了一个独立的交付物 → 一个场景
- 同一任务的连贯阶段 → 合并为一个场景，用工作流步骤体现
## Agent 标签规则
你必须在场景中标注自己的名称，出现在 3 个位置：
1. 场景索引链接：在场景名称后加 (Agent名称)，如 "S4 · xxx分析 (DuMate)"
2. Hero 标签云：加一个 Agent名称
3. 页脚徽章：用 Agent名称（dumate-badge 是通用样式类，任何 agent 都可以用，显示自己的名字）
常见 Agent 名称：DuMate / QClaw / Marvis / Hermes / WorkBuddy / 其他
## 追加规则
1. 文档位置：D:\baidu-pan\agent-scenes.html
2. 严禁覆盖已有内容，只能追加新场景
3. 操作步骤：
- 先读取 D:\baidu-pan\AGENT_SCENES_APPEND_PROMPT.md，里面有完整的追加规则、HTML模板和可用CSS类
- 读取 agent-scenes.html，找到最后一个 标记
- 用 edit 工具，oldString 设为该标记，newString 在其后插入新场景 + 新的结束标记
- 场景编号 = 当前最大编号 + 1（多个场景依次递增）
- 在文件顶部的"场景索引"区域追加新场景链接，链接文字包含 Agent 名称
4. 绝对禁止用 write 工具覆盖整个文件
5. 绝对禁止修改已有场景的任何内容
6. 如果识别出多个场景，依次追加，每个场景独立编号
```