Implementation_Rules

Implementation Rules for Agent

1. 工作分支与版本规则

• 直接在 main 工作；
• 不创建新的 Stage1 / Drizzle / Rxx 分支；
• 发布前统一视为 v1.0，不再额外发明版本号体系；
• 完成后回归 main 并保持分支清洁。

2. 工具链规则

Agent 必须优先使用并保留：

• source/tools/astro_toolkit.py
• 其他本地自制工具链（如你们为绕过沙箱/连续执行而制作的稳定工具）

要求：

• 不得遗忘、删除或绕开；
• 所有外部进程必须设置明确超时；
• 长耗时构建/测试要落盘日志；
• Git 操作、文件打包、批量命令尽量用工具链统一执行。

3. 不得阶段性停下

用户 Agent 按次计费，禁止阶段性停下等待下一次指令。只有触发本包定义的停止条件，才允许停止并交付中止说明。

4. 先冻结再修改

执行顺序：

1. 用本包内容更新 Wiki；
2. 使仓库 README 指向 Wiki，并保持一致；
3. 将旧文档中的冲突语义清理掉；
4. 再按本包进行代码与测试收尾；
5. 最后形成完整交付包。

5. 测试策略

• 优先使用合成数据完成严格科学验证；
• testdata 只做辅助验证；
• 不得再把完整真实单帧当主要调试手段；
• 完整真实单帧次数必须严格计数并最小化。