# 机器人写入规范

## 写入前先判断是否适合共享

机器人准备把经验写入 NAS 共享知识库前，必须先判断：这条内容是否会帮助公司多个机器人稳定协作，还是只属于某次任务、某个用户、某个机器人或某台机器。

优先写入：固定事实、最终 SOP、跨项目方法、脱敏案例、跨机器人协作规则、source-of-truth 路径索引。

不要写入：用户个人偏好、单个机器人私有记忆、实时项目待办、聊天过程、执行日志、修订草稿、临时猜测、未经确认状态。

## 写入前先判断归属

1. 具体 IP/项目的稳定事实：放 `01_IP资产与项目资料/具体项目/`。
2. 跨项目可复用方法：放对应业务 SOP，例如电商放 `02_电商业务SOP/`。
3. 设计、图片、视频、PPT、提示词的成熟方法：放 `03_内容设计与创意生产/`。
4. 运营推进方法、待办字段规范、活动/周报方法：放 `04_运营管理与项目推进/`；实时待办和当前进展不放知识库正文。
5. 授权、法务、合同、商务合作：放 `05_授权法务与商务合作/`。
6. 发票、报销、对账、财务表格：放 `06_财务报销与对账/`。
7. 机器人、系统、NAS、RAG、后台、云服务：放 `07_IT运维与系统工具/`；机器本地动态状态只放本地 source-of-truth 路径引用。
8. 还不成熟的机器人协作经验：可暂放 `08_机器人协作经验库/对应机器人/`，但不得包含用户个人偏好、私聊原文或单次情绪；成熟后提炼到对应业务 SOP。
9. 不确定：放 `99_待分类与待复核/`，不要强行归类；待复核内容不应长期停留。

## 用户偏好与机器人记忆边界

- 使用者对语气、审美、命名、工作方式、禁忌等偏好，默认写入对应机器人的 memory，不写入共享知识库。
- 如果某个偏好能转化为业务方法，必须去个人化后再入库。例如“用户喜欢谐音梗”应改写为“该类文创命名可考虑吉祥祝福、文化谐音、轻松记忆点，并以用户确认为准”。
- 某个机器人被纠正后的经验，先保存在该机器人的 memory/skill；只有跨机器人都会受益且不会扭曲其他业务时，才提炼成共享 SOP。

## 动态状态边界

- 当前负责人、下一步待办、截止时间、实时审批状态、未完成进度，应放项目工作区、任务系统、飞书文档或本地 source-of-truth 文件。
- 共享知识库只保存字段模板、管理方法、检查清单和稳定事实索引。
- 如果必须引用动态信息，只写“source-of-truth 文件路径/系统位置”，不要复制整张动态表。

## 版本与冲突

- 默认只保留最新有效版本。
- 遇到同名文件、需要改写已有知识、需要覆盖或删除时，必须先向用户确认具体路径、操作类型和风险。
- 不要自行生成很多 `v1/v2/日期版/修订版`。
- 如果新内容与旧规则冲突，先停止并让用户决定哪条规则作为 source of truth。

## 禁止写入

不要写入明文 API key、token、Feishu secret、NAS 密码、cookie、私钥、`.env`、`auth.json`、运行日志、缓存、虚拟环境、未经清理的私聊原文、个人完整流水、单次任务草稿、未验证机器人身份映射或未经确认的项目状态。