diff --git a/AGENTS.md b/AGENTS.md index 83e77c5..91f2ec8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -138,6 +138,34 @@ System: [...] Feishu[xiaobian] group oc_xxx | 发送者 (ou_xxx) [msg:om_xxx] 参与,而非主导。质量 > 数量。 +## 工作区目录规范(强制执行) + +工作区根目录只允许存在以下子目录和文件,**禁止在根目录下随意创建新的子目录或散落文件**: + +### 允许的子目录 + +| 目录 | 用途 | 说明 | +|------|------|------| +| `memory/` | 短期记忆 | 按天记录工作日志,格式 `YYYY-MM-DD.md` | +| `business_knowledge/` | 业务知识库 | **所有业务知识统一存放于此**,包括业务术语、数据表说明、SQL 模板、数据抽取脚本等 | +| `scripts/` | 脚本文件 | 所有 `.py`、`.sh`、`.sql` 等脚本文件必须放在此目录 | +| `output/` | 输出文件 | 所有生成的报表(`.xlsx`、`.csv`)、日志(`.log`)、导出文件等必须放在此目录 | +| `skills/` | 技能定义 | 个人技能目录 | +| `tmp/` | 临时文件 | 临时中间产物,可定期清理 | +| `backup/` | 归档备份 | 不再活跃使用的旧文件和目录 | + +### 允许的根目录文件 + +`AGENTS.md`、`SOUL.md`、`USER.md`、`MEMORY.md`、`TOOLS.md`、`IDENTITY.md`、`HEARTBEAT.md`、`BOOTSTRAP.md`、`secrets.env`、`.env`、`.gitignore` + +### 强制规则 + +1. **脚本文件** → 始终创建在 `scripts/` 目录下,绝不放在根目录 +2. **输出文件**(xlsx/csv/log/报表等)→ 始终创建在 `output/` 目录下,绝不放在根目录 +3. **业务知识** → 统一记录到 `business_knowledge/` 目录 +4. **新增子目录** → 禁止在根目录下随意创建新子目录。如有特殊需要,须经技术负责人确认 +5. **临时文件** → 使用 `tmp/`,用完即清 + ## 工具 Skills 提供你的工具。当你需要某个工具时,查看它的 `SKILL.md`。在 `TOOLS.md` 中保存环境相关的备注(数据库连接、API 配置等)。 @@ -181,7 +209,7 @@ Skills 提供你的工具。当你需要某个工具时,查看它的 `SKILL.md **使用定时任务的情况:** -需要设置定时任务时,参考以下技能: cron-schedule.vala (/root/.openclaw/skills/cron-schedule.vala) +定时任务相关需求,参考以下技能: cron-schedule.vala (/root/.openclaw/skills/cron-schedule.vala) - 精确时间很重要("每周一早上 9:00 整") - 任务需要与主会话历史隔离