AionClaw怎么在上下文里说明项目目录结构

胖雪吖_1374

胖雪吖_1374

2026-10-16

903人浏览

原创

必须在agents.md中用2空格缩进树状结构描述项目目录,并显式列出.openclaw/;关键目录需在下方用▶标注功能,如▶ src/是全部可编辑源码所在;选中项目根目录后顶部显示“当前工作区”才生效。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

aionclaw怎么在上下文里说明项目目录结构

要在AionClaw中让AI准确理解并操作你的项目,必须在上下文里清晰说明当前项目目录结构,否则AI可能误读文件位置、读错配置、甚至修改错误路径下的文件。

确认当前工作目录是项目根目录

打开AionClaw客户端,点击左下角「自动化」→「定时任务」→右上角「+新建任务」→在弹出窗口中点击「选择工作目录」按钮,手动导航并选中你的项目根文件夹(例如 【project/】),点击确定。这一步不可跳过,AionClaw不会自动推断你正在处理哪个项目,它只信任你显式指定的路径。

选完后,界面顶部会显示类似「当前工作区:/Users/you/project」的提示——只有看到这个,后续所有上下文描述才具备坐标基准。

在AGENTS.md中用树状缩进写明结构

在项目根目录下新建或编辑 AGENTS.md 文件,用纯文本树状格式逐级缩进描述,不加任何解释性文字,不使用代码块包裹。

示例写法:

AionClaw
AionClaw

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

下载

``` src/
├── components/
│ ├── Header.jsx
│ └── Footer.jsx
├── utils/
│ └── api.js
package.json
README.md
.env
.openclaw/
```

注意:缩进必须用空格(不能用Tab),每级缩进2个空格;文件名后不加斜杠,目录名后必须加斜杠;.openclaw/ 必须显式列出,因为AionClaw依赖该目录执行任务记录与缓存,AI若不知其存在,可能绕过关键机制。

对关键目录添加功能注释(仅限必要处)

在树状结构下方空一行,用短句说明1~2个核心目录的实际作用,每句以「▶」开头,仅标注真正影响AI行为的目录。

▶ src/ 是全部可编辑源码所在,所有代码修改必须在此目录内进行
▶ .openclaw/ 是AionClaw运行时自动生成和读取的任务日志与缓存目录,禁止手动删除或移动
▶ .env 包含敏感配置,读取时需跳过值内容,仅解析键名用于环境判断

不要为 README.md、package.json 这类通用文件加注释——AI已内置识别逻辑;只注释那些不标准、有业务特殊性的目录或文件,比如 custom-hooks/、legacy-migration/ 等。

验证上下文是否生效

方法一:在对话任务中直接输入「列出当前项目根目录下的所有一级子项」→AionClaw应返回你写在AGENTS.md中的 src/、package.json、.env 等名称,且顺序一致。
方法二:输入「.openclaw 目录里有哪些子目录」→应准确返回 config/、tasks/、logs/、cache/(前提是你的 .openclaw/ 目录真实存在且非空)。

如果返回「未找到 .openclaw 目录」或列表缺失,说明 AGENTS.md 未被加载——检查文件是否真的放在项目根目录,且文件名是全大写的 AGENTS.md(不是 agents.md 或 Agnets.md)。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

0

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

20

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

20

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程