{"id":50993520,"url":"https://github.com/sweetcornna/mathodology","last_synced_at":"2026-06-20T06:03:28.947Z","repository":{"id":352629728,"uuid":"1215895293","full_name":"sweetcornna/mathodology","owner":"sweetcornna","description":"Project-level Agent Skills pack for Mathodology, Claude Code, Codex, and AI coding agents","archived":false,"fork":false,"pushed_at":"2026-06-05T04:51:23.000Z","size":11879,"stargazers_count":3,"open_issues_count":16,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T07:21:04.009Z","etag":null,"topics":["agent-skills","ai-coding","claude-code","codex"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sweetcornna.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T11:06:58.000Z","updated_at":"2026-06-05T04:51:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sweetcornna/mathodology","commit_stats":null,"previous_names":["ymylive/mathodology","sweetcornna/mathodology"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/sweetcornna/mathodology","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sweetcornna%2Fmathodology","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sweetcornna%2Fmathodology/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sweetcornna%2Fmathodology/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sweetcornna%2Fmathodology/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sweetcornna","download_url":"https://codeload.github.com/sweetcornna/mathodology/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sweetcornna%2Fmathodology/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34558897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-coding","claude-code","codex"],"created_at":"2026-06-20T06:03:28.421Z","updated_at":"2026-06-20T06:03:28.938Z","avatar_url":"https://github.com/sweetcornna.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mathodology 数模竞赛 Skills\n\n**简体中文** · [English](./README_en.md)\n\n![license](https://img.shields.io/badge/license-MIT-blue)\n![format](https://img.shields.io/badge/format-Agent%20Skills-black)\n![tools](https://img.shields.io/badge/tools-Claude%20Code%20%7C%20Codex-blue)\n![contests](https://img.shields.io/badge/contests-MCM%2FICM%20%7C%20CUMCM%20%7C%20%E5%8D%8E%E6%95%B0%E6%9D%AF-orange)\n\nMathodology 是一套**专为数学建模竞赛设计的数模 Agent Skills**，面向 Claude Code、Codex 等兼容 Agent Skills 的 AI 编程工具。它把获奖级数模方法论——问题拆解、模型构建、可复现实验、获奖级论文写作、提交包组装——沉淀为可直接加载的项目 skills、subagents 和 workflow 模板。\n\n覆盖的竞赛类型：\n\n- **MCM/ICM（美赛）**：面向 Outstanding/Finalist 级产出\n- **CUMCM（全国大学生数学建模竞赛）**：面向国家一等奖级产出\n- **华数杯**、**M3**、**HiMCM/MidMCM**、**IMMC/IM2C**\n- leaderboard/数据科学型、运筹/政策/商业案例型、短时冲刺型竞赛\n\n本仓库是 skills-only 分支：刻意不包含原可运行应用源码，只保留项目级 skills、skill 元数据、轻量文档、备份脚本和许可证。\n\n## 仓库内容\n\n- `.claude/skills/\u003cskill-name\u003e/SKILL.md` 中的 Claude Code 项目 skills\n- `.claude/agents/` 中的 Claude Code 项目 subagents（建模、编码、论文、评审等分工角色）\n- `.claude/workflows/` 中的 Claude Code 竞赛 workflow 模板\n- 每个 skill 自带 `agents/openai.yaml`，方便 Codex 风格工具展示和调用\n- 根目录 `AGENTS.md`，给不会自动发现 project skills 的工具使用\n- `docs/` 下的 skills 和 workflow 文档\n- `mathodology-whole-project` skill 中的 skills-only 备份脚本\n\n这个分支不保留应用源码、CI workflow、部署文件、生成的 contracts、包锁文件、数据集、构建产物或安装器资源。\n\n## 一键安装与更新\n\n一条命令把全部 Mathodology skills 全局安装到 Codex 和 Claude Code：\n\n```bash\nnpx -y skills@latest add sweetcornna/mathodology --global --copy --yes --skill '*' --agent codex claude-code\n```\n\n一条命令更新已安装的 Mathodology skills：\n\n```bash\nnpx -y skills@latest update --global --yes mathodology-whole-project mathodology-agent-pipeline mathodology-dev-test-release mathodology-gateway-api mathodology-project-orientation mathodology-skill-authoring mathodology-web-ui\n```\n\n如果你用本仓库 checkout 来使用 Claude Code 项目 subagents 和 workflow 模板，请在 checkout 里运行完整一键更新器：\n\n```bash\ngit pull --ff-only \u0026\u0026 npx -y skills@latest update --global --yes mathodology-whole-project mathodology-agent-pipeline mathodology-dev-test-release mathodology-gateway-api mathodology-project-orientation mathodology-skill-authoring mathodology-web-ui\n```\n\n这条命令使用 `vercel-labs/skills` 提供的开放 `skills` CLI，从 GitHub 安装 Agent Skills 到对应 agent 的 skills 目录。\n\n安装或更新后重启 Codex 或 Claude Code，让新 skills、subagents 和 workflow 模板被发现。查看 CLI 帮助请用 `npx -y skills@latest --help`；不要使用 `skills add \u003crepo\u003e --help`，当前 CLI 版本可能会把它当成安装命令执行。\n\n更多目标和验证方式见 [docs/INSTALL_zh.md](docs/INSTALL_zh.md)。\n\n## Codex 与 Claude Code 模式\n\nMathodology 分别提供 Codex 和 Claude Code 的竞赛编排指导：\n\n- Claude Code：使用 `.claude/workflows/mathodology-award-submission.md`，并调用 `.claude/agents/` 中的项目 subagents。\n- Claude Code 竞赛类型适配：M3、HiMCM/MidMCM、IMMC/IM2C、leaderboard/data-science、运筹/政策/商业案例和短时冲刺赛使用 `.claude/workflows/mathodology-contest-variants.md`。\n- Codex：加载 `mathodology-whole-project`，按多 agents 模式执行 9 个 phase。\n\n两种模式都面向国奖或 MCM/ICM O 奖级别产出：多模型备选、有证据支撑的假设、可复现实验、成熟论文、完整提交包。类型适配器会把这些 gate 调整到论文优先、代码优先、冲刺型、中学生型和政策/商业案例型竞赛。\n\n完整 phase 模型见 [docs/WORKFLOWS_zh.md](docs/WORKFLOWS_zh.md)。\n\n## Skill 索引\n\n| Skill | 适用场景 |\n|---|---|\n| [`mathodology-whole-project`](.claude/skills/mathodology-whole-project/SKILL.md) | 整个 skills 仓库的备份、迁移、恢复、整体理解，或 Codex/Claude Code 竞赛工作流编排 |\n| [`mathodology-project-orientation`](.claude/skills/mathodology-project-orientation/SKILL.md) | 在 skills-only checkout 中开始工作，或验证仓库边界 |\n| [`mathodology-agent-pipeline`](.claude/skills/mathodology-agent-pipeline/SKILL.md) | 维护原 agent pipeline 的归档知识 |\n| [`mathodology-gateway-api`](.claude/skills/mathodology-gateway-api/SKILL.md) | 维护原 gateway 和 API 的归档知识 |\n| [`mathodology-web-ui`](.claude/skills/mathodology-web-ui/SKILL.md) | 维护原 Web UI 的归档知识 |\n| [`mathodology-dev-test-release`](.claude/skills/mathodology-dev-test-release/SKILL.md) | 验证 skills 仓库，或保留 dev、test、release 归档指导 |\n| [`mathodology-skill-authoring`](.claude/skills/mathodology-skill-authoring/SKILL.md) | 新增、更新、验证或 review 项目 skills |\n\n## 快速开始\n\n克隆仓库：\n\n```bash\ngit clone https://github.com/sweetcornna/mathodology.git\ncd mathodology\n```\n\nClaude Code 打开本仓库后，从这里加载 skills：\n\n```text\n.claude/skills/\n```\n\nCodex 或其他 AI 编程工具从这里开始：\n\n```text\nAGENTS.md\n```\n\n然后按任务加载 `mathodology-whole-project` 或更具体的 skill。拿到赛题后，直接按 [docs/WORKFLOWS_zh.md](docs/WORKFLOWS_zh.md) 的 phase 工作流开跑。\n\n## 备份与迁移\n\n创建 skills-only 备份：\n\n```bash\nbash .claude/skills/mathodology-whole-project/scripts/create-source-backup.sh\n```\n\n默认备份到仓库外：\n\n```text\n../mathodology_skills_backups/\u003ctimestamp\u003e/mathodology-skills-\u003ctimestamp\u003e.tar.gz\n```\n\n归档使用 skills 白名单，只包含当前保留的 skills 仓库文件。它会排除 `.git/`、secret、构建产物、运行时状态，以及本地可能残留的旧应用目录。\n\n恢复细节见 [docs/BACKUP.md](docs/BACKUP.md)。\n\n## 验证\n\n验证所有项目 skills：\n\n```bash\nfor d in .claude/skills/*; do\n  python3 /Users/cornna/.codex/skills/.system/skill-creator/scripts/quick_validate.py \"$d\"\ndone\n```\n\n检查元数据和目录一致性：\n\n```bash\npython3 - \u003c\u003c'PY'\nfrom pathlib import Path\nimport re\nimport yaml\n\nroot = Path(\".claude/skills\")\nfor d in sorted(p for p in root.iterdir() if p.is_dir()):\n    text = (d / \"SKILL.md\").read_text(encoding=\"utf-8\")\n    frontmatter = yaml.safe_load(re.match(r\"^---\\n(.*?)\\n---\\n\", text, re.S).group(1))\n    assert frontmatter[\"name\"] == d.name\n    assert frontmatter[\"description\"].startswith(\"Use when\")\n    assert (d / \"agents\" / \"openai.yaml\").exists()\nprint(\"skills ok\")\nPY\n```\n\n## 仓库策略\n\n保持这个分支只服务数模竞赛 skills。除非明确改变仓库策略，不要加回应用源码树、生成客户端、CI workflow、Docker 文件、安装器、数据集或构建产物。\n\n如果需要历史应用实现，可以从 Git 历史恢复；它不是当前 GitHub tree 的一部分。\n\n## 许可证\n\nMIT。见 [LICENSE](LICENSE)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsweetcornna%2Fmathodology","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsweetcornna%2Fmathodology","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsweetcornna%2Fmathodology/lists"}