oclaw/skills/_workspace/public/path-convention/SKILL.md

name	description
path-convention	Oclaw 项目路径规范。定义了项目根目录、用户数据区、技能目录、Wiki 记忆四者之间的路径关系。适用于：新建文件、读取文件、运行脚本、创建目录等所有涉及文件路径的操作之前。

路径规范 —— Path Convention

根目录

项目根 = 当前仓库根目录（workspace root）

所有 read_file、write_file、delete_file、move_file、mkdir 等工具的 path 参数支持两种写法：

• 相对路径：相对于项目根目录（workspace root）解析，例如 data/workspace/a.txt
• 绝对路径：按系统绝对路径解析（Windows 如 D:\...，Linux/macOS 如 /...），但仍受工作区路径访问策略约束

核心目录

用途	路径	说明
用户数据	data/workspace/	所有用户生成的文件放这里：脚本、文档、工作流、图片生成产物、测试文件等
技能文件	skills/	系统技能和用户安装的技能
Wiki 记忆	data/wiki/	长期记忆、Learnings、用户偏好、项目背景
临时文件	data/workspace/tmp/	临时中间文件

注意事项

• get_cwd() 返回项目根目录（workspace root）
• run_command 未传 cwd 时默认在项目根目录执行；需要在子目录执行时请显式传 cwd
• 用户数据只放在 data/workspace/ 下，不要直接散落在根目录
• data/wiki/ 仅存放结构化记忆，不要放脚本或工作流文件
• 技能安装路径见 skill_auto_install 工具，勿手动写入 skills/ 以外的技能目录