电赛报告 Skill

一个面向 全国大学生电子设计竞赛（NUEDC / 电赛）设计报告 的 Codex skill 仓库。它把优秀国奖、省奖报告的常见写法、本地报告语料观察、官方格式约束、图表规范和 PDF 快速审查流程整理成一条可复用链路，帮助你快速完成：报告起草、结构梳理、语言润色、图表规划、测试结果表达、匿名审查和最终提交前检查。

仓库名：Electronics-Design-Competition-Skill-3
Skill 名：nuedc-report
中文定位：电赛报告 skill

1. 这个 Skill 解决什么问题

电赛报告通常不是“把过程写下来”就够了，而是要在很短页数内讲清楚一条工程证明链：

题目要求 -> 方案选择 -> 理论计算 -> 硬件/软件实现 -> 测试证据 -> 是否满足指标

这个 skill 的目标是让 Codex 在处理电赛报告时自动按这条链路工作，而不是泛泛润色。它适合以下场景：

• 从零整理电赛设计报告提纲；
• 把零散实验记录整理成正式报告；
• 统一国奖、省奖报告常见结构；
• 优化摘要、系统方案、理论计算、硬件设计、软件设计、测试结果等章节；
• 规划框图、电路图、流程图、测试表；
• 检查匿名、页数、图表编号、测试证据、单位一致性；
• 对 PDF 报告做快速风险筛查。

2. 仓库结构

Electronics-Design-Competition-Skill-3/
├─ README.md
├─ .gitignore
├─ examples/
│  └─ simple-report-template.md
└─ nuedc-report/
   ├─ SKILL.md
   ├─ agents/
   │  └─ openai.yaml
   ├─ references/
   │  ├─ report-standard.md
   │  ├─ argument-structure.md
   │  ├─ figure-table-playbook.md
   │  ├─ audit-checklist.md
   │  └─ local-corpus-notes.md
   └─ scripts/
      └─ audit_report_pdf.py

各文件作用如下：

3. Skill 链路设计

3.1 主链路

当用户调用 $nuedc-report 或提出“电赛报告 / 设计报告 / 国奖报告 / 省奖报告 / TI杯报告”等请求时，Codex 应按下面链路执行：

用户需求
  ↓
读取 SKILL.md
  ↓
判断任务类型
  ├─ 起草/重构报告 -> argument-structure.md
  ├─ 检查格式/匿名/页数 -> report-standard.md
  ├─ 优化图表/测试表 -> figure-table-playbook.md
  ├─ 最终审稿/冲奖检查 -> audit-checklist.md
  └─ 参考本地优秀报告风格 -> local-corpus-notes.md
  ↓
生成报告结构 / 草稿 / 审查清单 / 图表清单
  ↓
必要时运行 audit_report_pdf.py 做 PDF 快速筛查
  ↓
输出可执行修改建议

3.2 五个核心原则

1. 要求先行：每一节都要回答题目要求，而不是介绍背景知识。
2. 方案有比较：系统方案不能只写“采用了什么”，还要写“为什么采用”。
3. 计算要落地：公式必须导出器件参数、控制参数、阈值或测试指标。
4. 测试要对表：每个基本要求和发挥要求都要在测试表中有对应证据。
5. 结论要克制：只总结实测能证明的内容，不写空泛的“性能优越”。

4. 安装与使用

4.1 在 Codex 中手动指定使用

如果没有安装到全局 skills 目录，也可以直接在任务中指定路径：

使用 E:\电赛报告\Electronics-Design-Competition-Skill-3\nuedc-re