Imported from Northffo/GPU-Queue-Lite (
docs/AGENTS.md). Install upstream withnpx skills add Northffo/GPU-Queue-Lite --skill docs. Copyright stays with the author.
Codex 执行规则:GPU 协作比赛项目
本文件仅用于内部开发,不直接提交赛事。已有仓库有 AGENTS.md 时先阅读并提出合并补丁,不覆盖原规则。冲突以用户最新明确授权和保守安全边界处理;本任务书不赋予任何新服务器权限。
1. 阅读与事实来源
先读 00_START_HERE、01_CONTEST_TASKBOOK、02_ENGINEERING_TASK_CARDS、05_PROGRESS_AND_SCHEDULE;需要测试时读 03,需要投稿材料时读 04,需要规则与工具事实时读 06。不要每轮重新扫描整台服务器。
计划不是结果,源码存在不是测试通过,测试通过不是实机上线,SMTP 接受不是用户收到,入围/参赛证明不是获奖。所有状态注明来源与时间;未知写 unknown。
当前批准的目录必须由用户给出。没有目录时只询问目录,不猜测 /home/... 或扫描所有项目。旧工程已存在时先盘点、复用可验收功能;不重建全部项目骨架。
2. 权限
默认允许:在批准的独立项目目录读写工程与文档,运行 CPU 单元测试/mock;依赖安装/下载先报告环境、来源和范围再按用户授权执行。
需另行明确批准:读取真实主机状态;安装/启用采集服务;内网访问部署;发测试邮件;处理真实用户信息;在空闲 GPU 上运行短验证;调用付费 API;导出/公开真实快照。
禁止:修改论文仓库/数据/训练配置/冻结协议;改变其 Conda/PyTorch/CUDA/驱动/内核;停止他人进程;GPU reset;改功耗/时钟;任意 shell 执行接口;读取密钥、完整进程 cmdline、环境变量、项目路径;扫描 home;挂载 docker.sock;privileged 容器;修改 UFW/SSH/路由;自动报名、缴费、申请专利、发邀请或公开 Git 仓库。
任务卡出现“部署/通知/提交”不等于得到外部动作授权。每次高影响操作先报告对象、变更、验证及回滚方式。
3. 实现边界
平台只控制自己的数据库、队列与通知。不能阻止原生 SSH 绕过预约;不得宣传物理隔离或阻止抢占。
占用观测、逻辑预约、训练成功是三件事。NVML 异常/权限缺失不写 0 或空闲;低利用率不判释放;结束占用默认需确认;自动结束仅逐次选择并告知风险。
GPU 用 UUID;PID 归属标注来源;共享 UID 不推断自然人。有效 lease 数据库唯一;两卡要原子分配;一个 coordinator;所有时间/统计有覆盖度;未知/失联暂停派号。
前端声明不能成为真实占用证据。生产不允许 demo 下拉选择身份直接修改他人预约;使用成熟认证组件和最小权限,不自行发明加密。
4. 一次一张任务卡
每轮先给:当前证据、任务编号、将修改文件、测试、需要授权的动作。用户确认范围后执行。只在同一张任务卡中完成最小变更;未授权不主动进入下一卡。
完成后报告:
- 实际修改文件与设计决策;
- 实际运行的命令、退出状态、关键结果;
- 未运行/跳过项与原因;
- 交付位置和验收证据;
- 用户必须亲自理解的核心逻辑;
- 当前阻塞及下一项最小建议。
测试失败不得删除测试、放宽未知处理或降低标准来伪造通过。新功能须同步测试;数据格式/默认阈值/状态迁移改变必须写 DECISIONS 与协议版本。
5. 证据与评测
mock/controlled/real 贯穿数据、报告、视频;不生成虚假客户、部署、访谈、节能、性能或获奖数据。指标从原始记录计算,失败纳入分母。只报告实际硬件和权限;本地 Windows/5060 测试不能代替 Linux 双卡验证。
阈值和样本数是建议,未执行标待测。测试集固定后不针对表现更换不利场景;偏离协议须保留旧版本。禁止从私人聊天/未批准日志推断基线。
6. 材料与匿名
内部 planning、权限文件、导师/队员身份、真实数据库绝不直接进 submission。
只能从批准的 commit 导出干净副本;不带 .git、密钥、远程 URL、路径、学校、导师、账号、邮箱、二维码或未公开研究信息。保留必须的第三方许可证;与匿名要求冲突时暂停并请求官方口径,不能擅自删署名。
指南中的“首次发表”、身份栏与匿名要求、AI 辅助披露、上传体积不自行解释。04 是草稿模板,填写真实事实并检查所有占位符后才可形成正式材料。
7. 进度与停止
不因本比赛自动修改 LoRA 月计划。个人时间按 05 执行,本项目替换原 A 时段,B/C/D 本期不启动。
10 月 5–12 日论文优先;10 月 18 日 G2 未通过,取消 Agent 和复杂展示;10 月 22 日功能/材料冻结。缺时间先缩功能,不取消安全测试和匿名审查。
安全疑义、规则未确认、权限不足、人时不够时,给出受限替代(mock、文档或待确认),不偷偷扩大权限或编造完成情况。提醒/计划不等于执行授权;每日最多两项主任务与一项可取消小任务。