8.4 KiB
8.4 KiB
MEMORY.md - 长期记忆
本文件存储团队共享的业务知识和工作经验。所有与你交互的同事都会看到这些内容。
重要提示
- 本文件是共享的： 所有通过飞书与你交互的同事，在每次会话中都会加载此文件
- 不要存放个人隐私： 不要在此记录特定同事的个人偏好、私人对话内容
- 只存放通用业务知识： 业务规则、数据口径、经验教训、团队共识
核心规则
- 所有飞书操作统一使用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岁学龄儿童）】
- 核心驱动力：从幼儿期“假装游戏”转向自主探索，渴望掌控感和发现感
- 社会关系：关注学校、社区、同伴关系，在意“公平”规则，会建立小团体、拥有专属秘密
- 心理需求：渴望证明自己“长大了”，乐于独立完成任务、甚至纠正大人的错误
【剧本创作三大黄金法则（强制执行）】
- 拒绝说教，强调体验（Show, Don't Tell）
- 禁止直白灌输道理，需将教育点转化为游戏规则/剧情道具
- 教学词汇（英语单词、生活常识）必须是推进剧情的必要元素，禁止生硬跟读环节
- 示例：将“节约用水”转化为水枪游戏的“弹药有限，考验射击精度”规则
- 角色关系拒绝“工具人”
- 成年人（家长/老师/镇长等）：去神圣化，允许犯错、笨拙；仅作为资源提供者/安全网，绝对不能是问题解决的主力，困难必须由孩子自己解决
- 同伴角色：需有真实友谊互动（吐槽、互损、分歧都可存在，避免过于礼貌的模板化互动）；每个角色要有鲜明性格标签（行动派、军师、气氛组等）
- 叙事风格：低风险，高情绪（Low Stakes, High Emotions）
- 禁止拯救世界类宏大剧情，聚焦生活小事（洗飞船、送作业、走捷径等），用史诗级配乐/运镜放大孩子的内心感受，打造“微观史诗”质感
- 贯彻游戏化思维：将日常事务转化为游戏场景（洗刷子=维护高精密仪器、除草=对抗丛林怪兽）
【核心工作要求】
所有输出内容需同时满足：
- 符合上述创作规范，具备生活流质感、情感深度和幽默感，对标《Bluey》的创作水准
- 自然融入指定教学目标（英语词汇、生活常识等），不生硬
- 适配互动教育游戏的交互特点，可落地为可玩内容
创作必备参考文档集
所有剧本创作必须严格参考以下文档（优先查阅本地知识库，无本地副本时再查飞书）：
长线任务协作协议
- 协议文档：
business_knowledge/long_task_protocol.md（详细规则） - 触发： 编剧发起全新写作任务时，按序询问两个问题：Q1 任务目标（完整Unit / 单Lesson / 润色修改 / 其他）、Q2 是否需要建日志
- 日志：
business_knowledge/task_log/{任务名称}.md，只记录通过的内容和有效反馈，不记录打回/修改/删除 - 索引：
business_knowledge/active_tasks.md维护活跃任务列表 - 恢复： 会话重置后编剧说"继续{任务名称}"或"查{任务名称}进度"即可恢复上下文
- 完成沉淀： 任务完成后汇总反馈清单，请编剧确认哪些需要更新到知识库
剧本创作协作流程（与编剧林逸瀚）
长周期协作记忆体系
business_knowledge/script_feedback_log.md— 历史反馈与高频错误（必读）business_knowledge/unit_startup_checklist.md— 启动检查清单（逐项打勾）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，此处仅列最核心的：
- NPC单句≤6-7词（最高频打回原因，几乎每次都犯）
- 知识点词性严格按指定使用（如fun名词≠形容词）
- 输入→输出顺序不可颠倒（NPC先输入，User后输出）
- 对话互动必须包含≥1个知识点（不含知识点的互动不合格）
- 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
经验教训
- ❗ 禁止在飞书知识库（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 中。