Skillget

mathodology

agent
Guvenlik Denetimi
Basarisiz
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 12 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in .claude/skills/mathodology-award-gates/scripts/pdf_qa.sh
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

专为数学建模竞赛设计的数模 Agent Skills：MCM/ICM 美赛、CUMCM 国赛、华数杯、M3、HiMCM 等，面向 Claude Code 与 Codex 的获奖级建模工作流。Math modeling contest skills for Claude Code & Codex.

README.md

Mathodology 数模竞赛 Skills

简体中文 · English

license
format
tools
contests

Mathodology 是一套专为数学建模竞赛设计的数模 Agent Skills，面向 Claude Code、Codex 等兼容 Agent Skills 的 AI 编程工具。它把获奖级数模方法论——问题拆解、模型构建、可复现实验、获奖级论文写作、提交包组装——沉淀为可直接加载的项目 skills、subagents 和 workflow 模板。

覆盖的竞赛类型：

  • MCM/ICM（美赛）：面向 Outstanding/Finalist 级产出
  • CUMCM（全国大学生数学建模竞赛）：面向国家一等奖级产出
  • 华数杯、M3、HiMCM/MidMCM、IMMC/IM2C
  • leaderboard/数据科学型、运筹/政策/商业案例型、短时冲刺型竞赛

本仓库是 skills-only 分支：刻意不包含原可运行应用源码，只保留项目级 skills、skill 元数据、轻量文档、备份脚本和许可证。

仓库内容

  • .claude/skills/<skill-name>/SKILL.md 中的 Claude Code 项目 skills
  • .claude/agents/ 中的 9 个 Claude Code 项目 subagents（建模、编码、论文、评审、盲评判审等分工角色）
  • .claude/workflows/ 中的 Claude Code 竞赛 workflow 模板
  • 每个 skill 自带 agents/openai.yaml，方便 Codex 风格工具展示和调用
  • 根目录 AGENTS.md，给不会自动发现 project skills 的工具使用
  • docs/ 下的 skills 和 workflow 文档
  • mathodology-whole-project skill 中的 skills-only 备份脚本

这个分支不保留应用源码、CI workflow、部署文件、生成的 contracts、包锁文件、数据集、构建产物或安装器资源。

一键安装与更新

一条命令把全部 Mathodology skills 全局安装到 Codex 和 Claude Code：

npx -y skills@latest add sweetcornna/mathodology --global --copy --yes --skill '*' --agent codex claude-code

一条命令更新已安装的 Mathodology skills：

npx -y skills@latest update --global --yes mathodology-whole-project mathodology-agent-pipeline mathodology-award-gates mathodology-dev-test-release mathodology-gateway-api mathodology-project-orientation mathodology-skill-authoring mathodology-web-ui

如果你用本仓库 checkout 来使用 Claude Code 项目 subagents 和 workflow 模板，请在 checkout 里运行完整一键更新器：

git pull --ff-only && npx -y skills@latest update --global --yes mathodology-whole-project mathodology-agent-pipeline mathodology-award-gates mathodology-dev-test-release mathodology-gateway-api mathodology-project-orientation mathodology-skill-authoring mathodology-web-ui

这条命令使用 vercel-labs/skills 提供的开放 skills CLI，从 GitHub 安装 Agent Skills 到对应 agent 的 skills 目录。

安装或更新后重启 Codex 或 Claude Code，让新 skills、subagents 和 workflow 模板被发现。查看 CLI 帮助请用 npx -y skills@latest --help；不要使用 skills add <repo> --help，当前 CLI 版本可能会把它当成安装命令执行。

更多目标和验证方式见 docs/INSTALL_zh.md。

Codex 与 Claude Code 模式

Mathodology 分别提供 Codex 和 Claude Code 的竞赛编排指导：

  • Claude Code：使用 .claude/workflows/mathodology-award-submission.md，并调用 .claude/agents/ 中的项目 subagents。
  • Claude Code 竞赛类型适配：M3、HiMCM/MidMCM、IMMC/IM2C、leaderboard/data-science、运筹/政策/商业案例和短时冲刺赛使用 .claude/workflows/mathodology-contest-variants.md。
  • Codex：加载 mathodology-whole-project，按多 agents 模式执行 9 个 phase。

两种模式都面向国奖或 MCM/ICM O 奖级别产出：多模型备选、有证据支撑的假设、可复现实验、成熟论文、完整提交包。类型适配器会把这些 gate 调整到论文优先、代码优先、冲刺型、中学生型和政策/商业案例型竞赛。

完整 phase 模型见 docs/WORKFLOWS_zh.md。

获奖级质量 gate

获奖级质量控制被做成可执行、有边界的机制，全部由 mathodology-award-gates skill 承载：

  • 独立三席盲评判审团：Phase 7 并行派发 3 个互不共享上下文的 mathodology-award-judge seat（旗舰通审 / 创新与决策效用 / 只审正确性与可复现），各自只拿到渲染 PDF 与产物清单打分；lead 按数值阈值聚合（Outstanding/国一 ≥85、floor 70），任一席位低于目标档即触发定向改进循环。
  • 有界迭代预算：每个 phase gate 最多 2 轮修复、Phase 7 最多 2 轮重评、全程上限 8 轮；耗尽后不静默继续，而是向用户发结构化 decision_memo 决策备忘。
  • 结构化 YAML handoff：specialist 交接、critic gate、判审 scorecard 都是带固定字段的 YAML 块，由 lint_run.py 脚本校验，杜绝自由文本漏项。
  • 随包发布的图表/PDF QA gate：figqa.py（bbox 碰撞硬门）和 pdf_qa.sh（渲染 PDF 页数、重复 caption、匿名性检查）随 skill 发布，直接执行而非每次重写。

Skill 索引

Skill 适用场景
mathodology-whole-project 整个 skills 仓库的备份、迁移、恢复、整体理解，或 Codex/Claude Code 竞赛工作流编排
mathodology-project-orientation 在 skills-only checkout 中开始工作，或验证仓库边界
mathodology-award-gates 运行竞赛时执行获奖级 phase gate、判审团、结构化 handoff、图表 QA 或渲染 PDF QA
mathodology-agent-pipeline 维护原 agent pipeline 的归档知识
mathodology-gateway-api 维护原 gateway 和 API 的归档知识
mathodology-web-ui 维护原 Web UI 的归档知识
mathodology-dev-test-release 验证 skills 仓库，或保留 dev、test、release 归档指导
mathodology-skill-authoring 新增、更新、验证或 review 项目 skills

快速开始

克隆仓库：

git clone https://github.com/sweetcornna/mathodology.git
cd mathodology

Claude Code 打开本仓库后，从这里加载 skills：

.claude/skills/

Codex 或其他 AI 编程工具从这里开始：

AGENTS.md

然后按任务加载 mathodology-whole-project 或更具体的 skill。拿到赛题后，直接按 docs/WORKFLOWS_zh.md 的 phase 工作流开跑。

备份与迁移

创建 skills-only 备份：

bash .claude/skills/mathodology-whole-project/scripts/create-source-backup.sh

默认备份到仓库外：

../mathodology_skills_backups/<timestamp>/mathodology-skills-<timestamp>.tar.gz

归档使用 skills 白名单，只包含当前保留的 skills 仓库文件。它会排除 .git/、secret、构建产物、运行时状态，以及本地可能残留的旧应用目录。

恢复细节见 docs/BACKUP.md。

验证

所有机械化仓库验证都收敛到一个脚本 validate_repo.py（纯标准库，无需 PyYAML），随 mathodology-dev-test-release skill 一起发布。不要再把这些检查以 heredoc 形式内联进文档或其他 skill。

从仓库根目录运行全部维护 gate：

python3 .claude/skills/mathodology-dev-test-release/scripts/validate_repo.py all

按名字单独运行某个 gate —— skills、metadata、links、whitelist、agents、sync 或 selftest：

python3 .claude/skills/mathodology-dev-test-release/scripts/validate_repo.py sync

all 覆盖 skill 与 agent 的 frontmatter、agents/openai.yaml 元数据、markdown 链接与 .claude/... 路径解析、tracked 文件白名单，以及中英文档孪生同步。mathodology-award-gates 与 mathodology-dev-test-release 携带的脚本各自带 --self-test。

仓库策略

保持这个分支只服务数模竞赛 skills。除非明确改变仓库策略，不要加回应用源码树、生成客户端、CI workflow、Docker 文件、安装器、数据集或构建产物。

如果需要历史应用实现，可以从 Git 历史恢复；它不是当前 GitHub tree 的一部分。

许可证

MIT。见 LICENSE。

Yorumlar (0)

Sonuc bulunamadi