必须按标准目录结构初始化agent-coding-plan-2026项目：根目录下执行mkdir -p src/{core,utils,agents} data/{raw,processed,reports} config logs tests，严格遵循路径语义、配置规则与agent入口约定，否则ai无法正确解析上下文或生成模块化代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为MiniMax Agent Coding Plan项目建立一套能被AI准确识别、可复用、不踩路径坑的本地目录结构，而不是随便建个文件夹就往里扔代码——AI在解析上下文时会依赖明确的路径语义，比如看到./data/raw/自动推断这是原始数据输入区，看到./src/utils/默认加载工具函数，路径混乱会导致Agent反复追问“请确认数据存放位置”或直接跳过关键模块生成。
初始化项目根目录与核心子目录
第一步：在任意磁盘新建空文件夹，命名为agent-coding-plan-2026（名称中必须含年份，避免与旧项目混淆）。
第二步：进入该文件夹，在终端执行以下命令一次性创建标准骨架：
mkdir -p src/{core,utils,agents} data/{raw,processed,reports} config logs tests
这一步不能手动画文件夹——手动创建容易漏掉src/core和src/agents的嵌套层级，而MiniMax Coding Plan在生成Agent逻辑时，会严格匹配src/agents/下的Python模块名作为可调用入口；若该目录不存在，它会降级为生成单文件脚本，失去模块化调度能力。
第三步：在根目录下创建.gitignore，填入__pycache__/、logs/*.log、config/secrets.json三行。Agent生成代码时可能引用config/下的配置，但绝不能把密钥写进版本库——【secrets.json必须加入.gitignore，否则API Key泄露风险不可逆】。
配置文件与环境隔离策略
MiniMax Coding Plan不会主动读取.env，它只认config/目录下的结构化JSON配置。你必须按此规则组织：
方法一：基础配置（适用于Starter套餐用户）
在config/下新建coding_plan.json，内容为：
{ "model": "MiniMax-M2.5", "timeout": 30, "max_retries": 2 }
方法二：多环境配置（适用于Plus及以上套餐）
在config/下新建dev.json、prod.json两个文件，分别填入开发/生产环境的group_id和api_base_url；再创建env.json指向当前激活环境：{ "active": "dev" }。Agent生成代码时会优先读取env.json，再加载对应环境配置——【active字段值必须小写且与文件名完全一致，大小写错误将导致配置加载失败】。
数据目录的命名与格式硬约束
Agent对data/目录下的子目录名有强语义绑定，不能自定义为input/或csv_source/：
① 所有原始数据（CSV/JSON/XLSX）必须放入data/raw/，且文件名不含空格和中文，例如sales_q1_2026.csv；
② Agent生成的数据处理脚本，默认输出路径为data/processed/，生成的报表默认存至data/reports/；
③ 若data/raw/为空，Agent会在第一轮响应中直接返回错误提示：“No raw data found in ./data/raw/ — aborting pipeline generation”，不会尝试猜测数据位置。
Agent代码存放与入口约定
Agent逻辑必须放在src/agents/下，且每个Agent对应一个独立的Python文件，文件名即为Agent ID：
方法1：单Agent项目
新建src/agents/price_tracker.py，文件开头必须包含文档字符串，描述该Agent职责，例如："""Track e-commerce SKU prices daily and alert on >5% change."""。Coding Plan会提取该字符串作为Agent功能摘要，用于后续多Agent编排。
方法2：多Agent协同项目
在src/agents/下并列创建data_loader.py、analyzer.py、notifier.py三个文件，各自文档字符串需体现上下游关系，例如analyzer.py中写："""Consume output from data_loader.py, compute metrics, pass result to notifier.py."""。Agent生成时会自动构建调用链，但前提是文件名和文档字符串同时满足语义连贯性。
最后，在src/core/下创建main.py，写入from agents.price_tracker import run（或对应Agent模块名）及if __name__ == "__main__": run()。这是Coding Plan识别项目启动入口的唯一方式——它不解析setup.py或pyproject.toml，只认src/core/main.py中的if __name__ == "__main__"块。
