COROS 运动记录分析

面向 Codex 和 Claude Code 的 COROS 运动分析技能。它通过 coros-mcp 读取运动记录、活动详情和分段数据，并从耐力教练视角给出训练判断与下一次训练建议。

每次完成单次运动或周期分析后，技能会生成 Markdown、HTML 和 PNG 三种报告。

主要能力

• 检查 COROS 授权状态，并在需要时引导浏览器登录。
• 查询跑步、骑行、游泳、徒步、力量训练等运动记录。
• 读取活动详情及 lap/segment 分段数据。
• 分析实际运动与休息时间、配速稳定性、前后半程变化和专项指标。
• 输出专业教练判断、风险提示和可执行的下一次训练处方。
• 自动生成 Markdown、HTML 和 PNG 图片报告。

依赖

• 已安装并可执行的 coros-mcp。
• 可访问 COROS MCP 服务的网络环境。
• 生成 PNG 报告时，需要本地浏览器和可用的 HTML 截图能力，例如 Playwright + Chrome。

中国区 COROS 账号默认使用：

coros-mcp --issuer https://mcpcn.coros.com login-status

安装

安装到共享技能目录

mkdir -p ~/.agents/skills
git clone git@github.com:SawyerPan/coros-activity-analysis.git \
  ~/.agents/skills/coros-activity-analysis

Codex 可以直接发现 ~/.agents/skills 下的技能。Claude Code 可以直接克隆到自己的技能目录，或者把技能目录指向同一个共享位置。

仅安装到 Claude Code

mkdir -p ~/.claude/skills
git clone git@github.com:SawyerPan/coros-activity-analysis.git \
  ~/.claude/skills/coros-activity-analysis

更新技能

git -C ~/.agents/skills/coros-activity-analysis pull --ff-only

使用示例

$coros-activity-analysis 分析最近一次游泳运动
$coros-activity-analysis 看看2026年5月份都有哪些运动记录
$coros-activity-analysis 分析6月份的运动

技能会先检查授权，再查询目标运动记录。对于单次运动，会读取活动详情和完整分段；对于周期分析，会选择有代表性或异常的训练补充详情和分段证据。

报告输出

报告统一保存在：

~/Documents/CorosAnalysis/YYYY-MM-DD/

子目录日期是分析执行日期。三种报告使用相同基础文件名，并包含运动日期和运动类型：

2026-07-05_泳池游泳.md
2026-07-05_泳池游泳.html
2026-07-05_泳池游泳.png

周期分析示例：

2026-06-01至2026-06-30_全部运动.md

如果同名报告已经存在，三种文件会统一增加 _02、_03 等后缀，不覆盖旧报告。

目录结构

coros-activity-analysis/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── analysis-template.md
│   └── coaching-framework.md
└── scripts/
    └── prepare_report_paths.py

安全说明

• 不要在对话中粘贴 COROS 用户名、密码、令牌或其他凭证。
• 浏览器登录由 COROS 授权页面完成。
• 运动分析不构成医疗诊断；设备指标和自动分段可能存在误差。

License

MIT