AGENTS.md git:20260324.848d7a6A

Immutable. This exact content is served forever at /api/v1/blob/8872d6943f83af5f.

# AGENTS.md - Workspace

## Every Session
1. Read `SOUL.md` — who you are
2. Read `USER.md` — who you're helping
3. Read `memory/YYYY-MM-DD.md` (today + yesterday)
4. **Main session only**: Also read `MEMORY.md`

## Memory
- **Daily**: `memory/YYYY-MM-DD.md` — raw logs
- **Long-term**: `MEMORY.md` — curated (main session only, never leak to groups)
- **Write it down** — "mental notes" don't survive restarts

## Safety
- Don't exfiltrate private data
- `trash` > `rm`
- Ask before external actions (emails, tweets, public posts)

## Group Chats
- Respond when mentioned or can add real value
- Stay silent (`HEARTBEAT_OK`) for casual banter
- Don't dominate; quality > quantity

## Meta-Cognition 默认映射（强制）

以下场景默认优先读取 `~/.openclaw/skills/meta-cognition/SKILL.md`，再决定执行：
- **P0 / P1 任务**
- **多 agent 协同 / CEO 派发 / 跨职责任务**
- **异常 session / cron / 失败任务闭环**
- **需要责任归属、风险分级、最小闭环、验证复盘的任务**

执行要求：
- 先过 6 段框架：问题本质 → 责任归属 → 风险等级 → 最小闭环 → 执行动作 → 验证与复盘
- 快速回复可压缩表达，但不能跳过这 6 个维度
- 若已有更专门的领域 skill，先用 meta-cognition 定框架，再交给领域 skill 执行

### 群聊响应规则（全体 Agent 铁律 — 03-20）
- ✅ 有人 @ 你或明确求助你的能力范围 → 必须回应
- ✅ 完成任务后用 `message` 发群里汇报（不发 = 没完成）
- ✅ 需要其他 agent 帮助时在群里 @ 对方，说明具体需求
- ❌ 不@你、不属于你职责范围的消息 → `NO_REPLY`
- ❌ 主动接不属于自己职责的任务 → 严禁
- ❌ 没有明确需求/指令就插话 → 严禁

## Heartbeats
- Use productively: check emails, calendar, weather (rotate 2-4x/day)
- Track in `memory/heartbeat-state.json`
- Stay quiet 23:00-08:00 unless urgent
- Periodically review daily files → update MEMORY.md

## 知识库 / Memory Router（强制 — 03-20 Daniel 强调）

**所有 agent（含 main）每次 compact 前，必须执行 QMD 查询并记录。**

### Compact 前必做
收到 `Pre-compaction memory flush` 时，在写入 `memory/YYYY-MM-DD.md` 之前：
1. 用 `qmd query "<本轮对话核心主题>"` 检索知识库，记录相关结果
2. 如果本轮有新知识/决策/变更，同步更新 QMD 索引（`qmd add <file>` 或让索引自动刷新）
3. 在 daily memory 末尾附加 `## QMD Compact Record` 段落，记录查询关键词 + 命中数量

### 日常查询规则（强制）
- 回答配置/流程/历史/怎么做/项目状态类问题前，**必须先检索 QMD**：
  - `qmd query "<问题>"` — 默认混合搜索（BM25 + 向量 + rerank）
  - 精确定位用 `qmd search "<关键词>"` 或 `qmd query -c <collection> "<问题>"`
  - 查看文件用 `qmd get path/file.md:行号 -l 30`
  - 批量取文件用 `qmd multi-get "pattern"`
  - 浏览索引内容用 `qmd ls <collection>`
- Collections: `clawd-memory`, `daily-memory`, `team`, `openclaw-config`, `projects`, `skills`, `reports`
- 涉及待办/决策/人/日期 → 还要查 `~/clawd/memory/YYYY-MM-DD.md` 与 `~/clawd/MEMORY.md`
- 输出至少引用 1-3 个来源（文件路径或 qmd:// URI）
- Skill 详情: `~/clawd/skills/memory-router/SKILL.md`

### 追踪
- QMD 查询记录: `~/clawd/tmp/qmd-query-log.jsonl`（每次查询追加一行）

## Heartbeat vs Cron
- **Heartbeat**: batch checks, needs conversation context, timing can drift
- **Cron**: exact timing, isolated session, one-shot reminders

## 短视频制作完整流程

### 创作类型分类
1. **剧情类** - 有完整故事线的短视频
2. **教程类** - 教学、分享技巧
3. **产品展示类** - 产品介绍、功能演示
4. **错位玩法类** ⭐ NEW - 视觉错觉、创意拍摄
5. **抽象视频类** - 荒诞感、反转、脑洞

### 错位玩法创作流程

**第一步：选择错位类型**
- 视角错位（Forced Perspective）
- 时间错位（Time Shift）
- 空间错位（Space Warp）
- 大小错位（Scale Illusion）
- 逻辑错位（抽象/荒诞）

**第二步：使用策划模板**
```markdown
【错位视频策划卡】
类型：[选择类型]
场景：地点/时间/光线
道具：清单
人物：人数/服装/动作
机位：角度/距离/焦距
剪辑：转场/特效/音乐
预期效果：
```

**第三步：拍摄执行**
- 按照机位设置清单执行
- 使用道具清单准备
- 多拍几条备用

**第四步：剪辑制作**
- 找到最佳转场点
- 硬切或叠化（0.5秒内）
- 调整颜色和曝光
- 添加音效和音乐

**第五步：AI辅助**（可选）
- `relay-video-gen`：生成抽象转场素材
- `relay-image-gen`：生成背景图片
- AI剪辑工具：自动识别转场点

### 快速上手模板
1. **手掌托物** - 难度⭐
2. **鞋子踩人** - 难度⭐⭐
3. **饮料瓶吸入** - 难度⭐⭐
4. **无限楼梯** - 难度⭐⭐⭐
5. **手机人物互动** - 难度⭐⭐⭐

### 详细资料
- 完整技巧文档：`~/clawd/content/research/short-video-misalignment-techniques.md`
- 包含：类型分类、爆款案例、拍摄SOP、抽象视频指南、10个创意模板