# MEMORY.md - 长期记忆

本文件存储团队共享的业务知识和工作经验。所有与你交互的同事都会看到这些内容。

## 重要提示

- **本文件是共享的：** 所有通过飞书与你交互的同事，在每次会话中都会加载此文件
- **不要存放个人隐私：** 不要在此记录特定同事的个人偏好、私人对话内容
- **只存放通用业务知识：** 业务规则、数据口径、经验教训、团队共识

## 核心规则

- ❗❗ **身份红线（永不可违背）：** 我是小编（xiaobian），只能使用 xiaobian 的凭证操作飞书。不得擅自调用 xiaoyan 或其他任何应用的凭证。遇到问题应先排查自身凭证问题，而非绕道用其他应用
- 所有飞书操作统一使用Bot身份执行，禁止触发用户授权
- 飞书消息发送：使用 `skills/lark-send-message-as-bot.vala` 或官方 `lark-im` 技能
- 飞书知识库读写：使用 `skills/lark_wiki_operate_as_bot.vala` 或官方 `lark-wiki` / `lark-doc` 技能，仅支持知识库（/wiki/）文档
- 飞书电子表格读取：通过 Sheets V2 API + Bot tenant_access_token 直接调用（详见 TOOLS.md）
- 飞书CLI（lark-cli v1.0.27）官方24个skills已安装在 `.agents/skills/lark-*` 目录下

## 业务知识

### 儿童动画编剧创作规范（面向5-9岁儿童互动教育游戏脚本）
#### 【受众心理画像（5-9岁学龄儿童）】
1. 核心驱动力：从幼儿期“假装游戏”转向**自主探索**，渴望掌控感和发现感
2. 社会关系：关注学校、社区、同伴关系，在意“公平”规则，会建立小团体、拥有专属秘密
3. 心理需求：渴望证明自己“长大了”，乐于独立完成任务、甚至纠正大人的错误

#### 【剧本创作三大黄金法则（强制执行）】
1. 拒绝说教，强调体验（Show, Don't Tell）
   - 禁止直白灌输道理，需将教育点转化为游戏规则/剧情道具
   - 教学词汇（英语单词、生活常识）必须是推进剧情的必要元素，禁止生硬跟读环节
   - 示例：将“节约用水”转化为水枪游戏的“弹药有限，考验射击精度”规则
2. 角色关系拒绝“工具人”
   - 成年人（家长/老师/镇长等）：去神圣化，允许犯错、笨拙；仅作为资源提供者/安全网，绝对不能是问题解决的主力，困难必须由孩子自己解决
   - 同伴角色：需有真实友谊互动（吐槽、互损、分歧都可存在，避免过于礼貌的模板化互动）；每个角色要有鲜明性格标签（行动派、军师、气氛组等）
3. 叙事风格：低风险，高情绪（Low Stakes, High Emotions）
   - 禁止拯救世界类宏大剧情，聚焦生活小事（洗飞船、送作业、走捷径等），用史诗级配乐/运镜放大孩子的内心感受，打造“微观史诗”质感
   - 贯彻游戏化思维：将日常事务转化为游戏场景（洗刷子=维护高精密仪器、除草=对抗丛林怪兽）

#### 【核心工作要求】
所有输出内容需同时满足：
1. 符合上述创作规范，具备生活流质感、情感深度和幽默感，对标《Bluey》的创作水准
2. 自然融入指定教学目标（英语词汇、生活常识等），不生硬
3. 适配互动教育游戏的交互特点，可落地为可玩内容

### 创作必备参考文档集
所有剧本创作必须严格参考以下文档（优先查阅本地知识库，无本地副本时再查飞书）：

| # | 文档 | 本地路径 | 飞书备用链接 |
|---|------|----------|----------------|
| 1 | 故事创作风格指南 | `skills/children-english-script-writing/references/儿童互动英语剧本创作指南.md` | https://makee-interactive.feishu.cn/wiki/Mtkzw8dYfify2oktHOucldEznfg |
| 2 | 世界观背景设定 | `business_knowledge/resources/worldview_L1_desert_town.md`（已同步）。↠️ L1故事概览.pdf 无权下载 | https://makee-interactive.feishu.cn/wiki/VmDyw99Qji1XsVktgEPcDUxnnUh 、 https://makee-interactive.feishu.cn/wiki/MgihwBMp5iParuk9gnccPb6inye |
| 3 | 角色外观及简单描述 | `business_knowledge/characters/`（main/ + supporting/） | https://makee-interactive.feishu.cn/wiki/EqAtwOIqsiMQZ3kYEn3cCSCtnWb |
| 4 | 场景地图及简单描述 | `business_knowledge/resources/scene_catalog.md` | https://makee-interactive.feishu.cn/wiki/GR9awIhYniL4uZkiH3ac4VB1nYf |
| 5 | Level 1 - S1已完成剧本 | `business_knowledge/chapters/Level1/S1/`（12个unit概要） | https://makee-interactive.feishu.cn/wiki/Ri39w7g2VifUkgkVUhecvxjonfb |
| 6 | Level 1 - S2撰写中剧本 | `business_knowledge/chapters/Level1/S2/`（8个unit概要） | https://makee-interactive.feishu.cn/wiki/TekjwhXLbioX2OkR1H6chg6Hnah |
| 7 | 编剧共识规则 | `business_knowledge/script_feedback_log.md`（以此为准） | https://makee-interactive.feishu.cn/wiki/DqjUw4sKNiGhTBkygz8cPAicnXe |
| 8 | 剧本可用emoji对照表 | `business_knowledge/resources/emoji_catalog.md` | https://makee-interactive.feishu.cn/wiki/X3lHweh3hi2XBokgA6rcRhTRnvg |

## 长线任务协作协议

- **协议文档：** `business_knowledge/long_task_protocol.md`（详细规则）
- **触发：** 编剧发起全新写作任务时，按序询问两个问题：Q1 任务目标（完整Unit / 单Lesson / 润色修改 / 其他）、Q2 是否需要建日志
- **日志：** `business_knowledge/task_log/{任务名称}.md`，只记录通过的内容和有效反馈，不记录打回/修改/删除
- **索引：** `business_knowledge/active_tasks.md` 维护活跃任务列表
- **恢复：** 会话重置后编剧说"继续{任务名称}"或"查{任务名称}进度"即可恢复上下文
- **完成沉淀：** 任务完成后汇总反馈清单，请编剧确认哪些需要更新到知识库

## 剧本创作协作流程（与编剧林逸瀚）

### 长周期协作记忆体系
1. `business_knowledge/script_feedback_log.md` — 历史反馈与高频错误（必读）
2. `business_knowledge/unit_startup_checklist.md` — 启动检查清单（逐项打勾）
3. `memory/Uxx_progress.md`（上期）— 关键决策记录复用到新Unit

### 协作Pipeline（5 Lesson × 起承转合，约2周/Unit）
```
大纲+知识点确认 → 节奏表(2-3轮迭代) → 剧本撰写 → 编剧审阅(1-2轮) → 飞书电子表格定稿
```
每个「起/承/转/合」独立走一轮完整流程。

### 高频经验（U18 L2/L5 + U22 L1/L2 沉淀）
详见 `business_knowledge/script_feedback_log.md`，此处仅列最核心的：
1. **NPC单句≤6-7词**（最高频打回原因，几乎每次都犯）
2. **知识点词性严格按指定使用**（如fun名词≠形容词）
3. **输入→输出顺序不可颠倒**（NPC先输入，User后输出）
4. **对话互动必须包含≥1个知识点**（不含知识点的互动不合格）
5. **DiDi/BoBo不在大人面前亮相**（角色设定铁律）

---

## 技能目录结构

- `.agents/skills/`：飞书官方24个 lark-* 技能源文件（由飞书开放平台 well-known 自动安装管理）
- `skills/`：自定义业务技能 + 个人技能，优先级最高（同名冲突时覆盖 `.agents/skills/`）
- `skills-lock.json`：OpenClaw自动维护的技能锁定文件，记录官方技能的来源和hash校验值
- 技能加载优先级：`skills/` > `.agents/skills/` > `~/.agents/skills/` > `~/.openclaw/skills/` > bundled > `extraDirs`

## 经验教训

- ❗ lark-cli 认证失败但 curl 直接调用正常时，检查 `{CONFIG_DIR}/openclaw/config.json` 是否存在且格式正确（lark-cli 优先读取此文件）
- ❗ 飞书文档精确更新推荐用 DocX Block API（先获取 blocks 找到 block_id，再逐个 PATCH），比 str_replace 更稳定
- ❗ **禁止在飞书知识库（Wiki）中新建文档** —— 知识库由编剧团队维护，Bot只做读取。输出文件（剧本表格等）应创建为独立的电子表格（Sheets），不要放入Wiki知识库
- 飞书sheet类型文档无法通过 `lark-cli docs +fetch` 读取，需用 Sheets V2 API
- 飞书知识库中的PDF文件需通过 Drive API 下载到本地后用pdf工具解析
- ClawHub安装skill时如遇VirusTotal警告，使用 `--force` 参数强制安装
- feishu-sheet（ClawHub）脚本从 `openclaw.json` 顶层读凭证，但我们的凭证分账号存储，需直接用API调用
- Office文档处理（python-docx/openpyxl/python-pptx）需先激活虚拟环境：`source skills/office-document-specialist-suite/.venv/bin/activate`
- 批量删除文件时避免使用通配符 `rm prefix-*`，可能误删以相同前缀开头的真实目录。应使用 `find -type l` 等类型过滤条件精确匹配操作目标
- 飞书合并表（z23MyW等）不支持 insertDimension API（错误码 90204），插入行需用覆盖空行/组合内容方案
- 合并表跨段列布局可能不一致（如段①②④对话在 Col E 而场景在 Col C，段③场景在 Col C 角色在 Col D 对话在 Col E），操作前必须读目标行完整列值确认布局

---

此文件由数字员工在工作过程中持续维护和更新。敏感信息和权限相关内容请维护在 `USER.md` 中。