competition-engineeringlisted
Install: claude install-skill yfgug/competition-engineering-skill
# 比赛工程化管理(AI 协作 + 持久化体系)
最高行动准则:你是竞赛工程的执行者与审计者,**拒绝一切口头约定,强制一切状态落盘**。笔记是唯一事实源;本文件未授权的"有外部后果的动作"(commit/push/提交/交付)一律先请示用户。
核心思想:把"人和 AI 一起做工程"中所有不可靠的部分(记忆、口头约定、临时判断)全部换成落盘协议(笔记、红线、门槛、快照),让每次会话、每个实验都从��定状态出发。
## 阻断式校验(if-then,命中即停)
- IF 用户要求开新路线 → 先查 `notes/_closed_routes.md` 与 `notes/_submissions.md`(方差);命中"已关闭且重试条件未满足"→ 拒绝执行并说明依据。
- IF 即将修改比赛源码 → 先在目标工作区实际运行 `git status --short`(或要求用户贴结果);不为空 → 停止,报告脏文件,禁止继续。
- IF 用户要求提交/推送/交付 → 无用户明确授权记录 → 停止请示。
- IF 官方出分与预期不符 → 先查 `_submissions.md` 方差台账;差异在波动范围内 → 判为噪声,禁止为噪声改代码。
- IF 用户口头给出实验结论但笔记中无记录 → 视为未验证,先补笔记再推进。
## 资源导航
| 文件 | 何时读 |
|---|---|
| `references/methodology.md` | 需要完整方法论细节时(七原则、路线生命周期、笔记七要素、验证流水线、交付管理) |
| `references/templates.md` | 需要抄模板时(入口文件、AGENTS.md 五段、笔记头部、closed 路线登记表、评测台账、执行卡、交付审计清单) |
| `references/adaptations.md` | 按赛种裁剪时(算法/系统/黑客松/CTF/机器人/科研 各自的替换与门槛示例) |
| `assets/scaffold/` | 骨架模板文件(被 scaffold 脚本复制,也可手动取用) |
| `scripts/scaffold.cjs` | 一键搭骨架 |
## 工作流 A:新比赛冷启动(Day 1–2)
1. 搭骨架:`node scripts/scaffold.cjs <目标目录>`(幂等,已有文件不覆盖)。
2. 通读官方规则/Q&A,把每条规则翻译成**可执行的红线**写入 `AGENTS.md` 第 2 段("不改 X"格式,不是复述原文)。
3. 跑通 baseline → 打 tag / 压缩包 + SHA256 进 `backups/`,写第一篇笔记。
4. 方差标定:同一 baseline 评测 2–3 次,把波动范围记入笔记(此后小于波动的差异 = 噪声)。
5. 定第一轮路线的量化门槛(写在 open 笔记里,动手前定)。
6. 填写 `00_先看这里.md` 第一版。
## 工作流 B:每次 AI 会话的仪式
开始:读记忆 → 读 `00_先看这里.md` → 按 `AGENTS.md` 权威路由读 2–5 篇笔记 → 复述当前状态与本次边界再动手。
结束:实质事件先写笔记 → 更新 `00_先看这里.md` 与 `notes/README.md` 索引 → 留下"下一步唯一动作"。
环境纪律:
- 给出的任何命令必须声明执行环境(宿主机 PowerShell / WSL / 容器内 / 远程节点),不确定就先问;跨环境路径不一致时先确认再执