aionclaw编写代码前必须提供三项硬性背景：①目标运行平台（windows/macos/linux）；②python主版本号（3.9/3.10/3.11/3.12）；③项目是否已存在git仓库，否则将导致路径错位、语法报错或版本管理失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在AionClaw中启动代码编写任务前，必须向它提供明确的项目背景信息，否则生成的代码可能脱离实际运行环境、缺少依赖声明、无法对接已有模块，甚至因路径/权限/框架版本误判而直接报错。没有上下文的“写个Python脚本”指令，AionClaw会按最小公约数逻辑生成通用模板，不包含你项目里正在用的FastAPI路由结构、Vue3组件命名规范或私有PyPI源配置。
必须提供的核心项目背景
第一步：说明当前项目所处的技术栈层级
明确是「纯前端页面」「后端服务接口」「桌面自动化脚本」还是「混合型本地工具」。例如：“这是一个运行在Windows上的Excel批量处理工具，用Python 3.11开发，不联网，所有依赖需打包进exe”。若只说“写个自动化脚本”，AionClaw默认按Linux CLI工具生成，路径分隔符、权限检查、日志输出方式全部错位。
第二步：指出已有工程结构的关键锚点
提供入口文件名（如main.py）、核心配置文件（如config.yaml）、依赖管理方式（requirements.txt / pyproject.toml / conda env）。【入口文件名缺失会导致AionClaw无法生成可执行逻辑链，只会返回零散函数片段】。若项目已存在src/目录且主程序在src/cli.py，必须明示，否则它可能把新代码生成到根目录，破坏原有包结构。
第三步：声明硬性约束条件
包括但不限于：是否允许调用外部API、能否写入注册表、是否必须兼容Python 3.9+、是否需适配ARM64架构、是否要嵌入GUI界面。这些不是可选偏好，而是决定代码能否编译通过的刚性边界。例如“需打包为单文件exe且体积≤15MB”，这直接排除requests等重型库，AionClaw会自动切换到httpx+手动证书管理方案。
推荐补充但非强制的背景信息
方法一：粘贴关键代码片段
把已有类定义、数据模型或API响应示例直接发给AionClaw。它能据此推断字段命名风格、错误处理惯用法、序列化偏好（dataclass/jsonable_encoder/pydantic v2）。不需要全量代码，3～5行典型结构足够建立语义锚点。
方法二：描述最近一次失败的报错现象
比如“上次运行时提示ModuleNotFoundError: No module named 'win32com.client'，但我已用pip install pywin32安装”。这类信息能让AionClaw识别出你的环境实际使用的是conda而非venv，进而生成对应激活命令和依赖声明格式。
方法三：说明该段代码在工作流中的触发时机
是用户点击按钮后执行？定时任务凌晨2点跑？还是监听某个文件夹变化自动触发？这影响AionClaw对异步模型的选择（asyncio.run() vs threading.Thread vs APScheduler），也决定是否需要加入进程锁防重复执行。
绝对禁止省略的三项内容
① 目标运行平台（Windows/macOS/Linux）
② Python解释器主版本号（3.9/3.10/3.11/3.12）
③ 当前项目是否已存在git仓库（影响AionClaw是否生成.gitignore条目及版本号注入逻辑）
【若未声明Python版本，AionClaw将按3.12语法生成match-case和类型别名，导致3.9环境直接SyntaxError】
