AGENTS.md · diff
git:20260324.848d7a6 to git:20260722.26d3003
17 added, 128 removed. Audit A to A.
- # 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
+ # Contributor and coding-agent entrypoint
- ## 短视频制作完整流程
+ Before changing this repository:
- ### 创作类型分类
- 1. **剧情类** - 有完整故事线的短视频
- 2. **教程类** - 教学、分享技巧
- 3. **产品展示类** - 产品介绍、功能演示
- 4. **错位玩法类** ⭐ NEW - 视觉错觉、创意拍摄
- 5. **抽象视频类** - 荒诞感、反转、脑洞
+ 1. Read [`CONTEXT.md`](./CONTEXT.md) for shared domain and architecture language.
+ 2. Read [`ARCHITECTURE.md`](./ARCHITECTURE.md) for Modules, authority, generated outputs, Adapters, and change routes.
+ 3. Read [`CONTRIBUTING.md`](./CONTRIBUTING.md) and the relevant decision in [`docs/adr/`](./docs/adr/).
+ 4. Treat [`config/repository-architecture.json`](./config/repository-architecture.json) as the path-ownership contract.
- ### 错位玩法创作流程
+ Do not edit generated `catalog/` files by hand. Change their authored inputs and run `npm run build:skills`. Do not present a tracked skill, manifest, or distribution package as runtime-verified without a commit-matched receipt.
- **第一步：选择错位类型**
- - 视角错位（Forced Perspective）
- - 时间错位（Time Shift）
- - 空间错位（Space Warp）
- - 大小错位（Scale Illusion）
- - 逻辑错位（抽象/荒诞）
+ Before handing off changes, run the relevant focused tests and then:
- **第二步：使用策划模板**
- ```markdown
- 【错位视频策划卡】
- 类型：[选择类型]
- 场景：地点/时间/光线
- 道具：清单
- 人物：人数/服装/动作
- 机位：角度/距离/焦距
- 剪辑：转场/特效/音乐
- 预期效果：
+ ```bash
+ python3 -m venv .venv
+ . .venv/bin/activate
+ python -m pip install --requirement requirements-dev.txt
+ npm test
+ npm run validate:strict
+ npm run check:architecture
+ git diff --check
```
- **第三步：拍摄执行**
- - 按照机位设置清单执行
- - 使用道具清单准备
- - 多拍几条备用
-
- **第四步：剪辑制作**
- - 找到最佳转场点
- - 硬切或叠化（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个创意模板
+ Preserve unrelated worktree changes. Never publish, merge, deploy, or send external messages unless the user explicitly authorizes that action.