必须按照标准目录结构初始化agent-coding-plan-2026项目：在根目录执行mkdir -p src/{core,utils,agents} data/{raw,processed,reports} config logs tests，严格遵守路径语义、配置规范与Agent入口约定，否则AI将无法准确解析上下文，甚至影响模块化代码的生成效果。
为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__"代码块。