接手代码项目前必须提供项目结构与入口点、技术栈与运行约束、当前任务目标与边界、已有线索与错误现场四类核心上下文,否则aionclaw易误操作或失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

接手代码项目前必须提供的核心上下文
当你用 AionClaw 处理一个陌生代码仓库时,它无法像人类开发者那样靠扫几眼 README 就建立认知,必须由你明确喂给它结构化、可定位、带边界的上下文信息,否则它可能在错误目录里改错文件,或把测试用例当成主逻辑来优化。
项目结构与入口点说明
提供一份清晰的目录树快照,重点标注:根目录下哪些是源码目录(如 src/、app/)、哪些是配置目录(如 config/、.env.example)、哪些是构建产物(如 dist/、build/)——AionClaw 默认不会主动跳过 node_modules 或 .git,但如果你不指明“忽略这些”,它可能花 3 分钟扫描 12 万个小文件。
明确指出程序启动入口:是 main.py 还是 index.js?是 npm start 还是 docker-compose up?这一步漏掉,AionClaw 会默认从当前工作区根目录开始推理,容易把 README.md 当成执行起点。
技术栈与运行约束
方法一:直接粘贴 package.json 的 engines 字段或 pyproject.toml 的 requires-python 值。例如:"engines": {"node": ">=18.17.0", "npm": ">=9.6.7"}。
方法二:用自然语言写清三件事:主语言版本(Python 3.11)、关键依赖(FastAPI 0.115、React 18.3)、运行环境特征(需 Redis 实例、依赖 PostgreSQL 15+)。【不要只写‘用 Python 写的’——AionClaw 会按 Python 3.9 启动解释器,而你的代码用了 3.12 的新语法】
当前任务目标与边界定义
第一步:用一句话锁定目标。例如:“修复登录页点击提交后无响应的问题,仅修改前端交互逻辑,不碰后端 API 接口”。
第二步:划出本次操作的绝对禁区。例如:“禁止修改 api/auth/ 下任何文件”“tests/e2e/ 目录下的脚本不得执行”。
第三步:指定验证方式。例如:“本地 yarn dev 启动后,打开 http://localhost:3000/login,输入 test@test.com / 123456,应看到跳转至 /dashboard 页面”。没有这一步,AionClaw 可能生成一堆代码却无法确认是否真正解决问题。
已有线索与错误现场
把终端报错截图里的关键行直接复制进来,包括堆栈最顶端的错误类型(如 TypeError: Cannot read properties of undefined (reading 'token'))和发生位置(at LoginButton.jsx:42:18)。AionClaw 会优先锚定这个文件和行号做上下文裁剪,而不是在整个仓库里模糊搜索 “token”。
如果已有调试结论,比如“确认是 useAuthStore() 返回值为空”,请直接写明——这能让 AionClaw 跳过 80% 的无效分析路径,直奔状态管理模块。











