核心用法
Hevy CLI Skill 是一款面向健身爱好者的纯文档型辅助工具，旨在帮助用户通过命令行界面高效管理和分析 Hevy 健身追踪应用中的个人数据。该 Skill 本身不执行任何代码，而是提供详尽的操作指南，指导用户安装和使用 hevycli 命令行工具完成以下核心操作：
1. 数据查询：查看训练历史记录、获取单次训练详情（包含组数、次数、重量等）、浏览训练计划和动作模板库。
2. 数据导出：支持将训练记录、常规计划以 JSON 格式导出，便于后续进行深度数据分析或迁移至其他平台。
3. 进度统计：快速查询累计完成训练次数，辅助用户追踪长期健身成果。
使用流程为：用户需先安装 Go 语言编写的 hevycli 工具并配置 Hevy API 密钥（需 Hevy Pro 订阅），随后即可通过 Skill 提供的命令模板进行交互式数据访问。Skill 支持表格和 JSON 两种输出格式，推荐使用 JSON 格式以便 Agent 进行自动化分析和洞察生成，如计算训练容量、识别训练频率模式、建议恢复周期等。
显著优点
1. 零安全风险设计：作为纯 Markdown 文档型 Skill，无可执行代码、无第三方依赖、无网络调用，从根本上消除了代码注入、恶意依赖和隐私泄露风险，安全评分达满分。
2. 数据源权威性：直接对接 Hevy 官方平台数据，Hevy 是健身领域主流的专业训练记录应用，数据结构和计量标准（千克、米、秒、ISO 8601 时间格式）规范统一。
3. 灵活的分析能力：通过 JSON 导出功能，用户可将数据交由 AI Agent 进行多维度分析，包括训练量趋势可视化、动作进步曲线、周期性训练规划建议等，实现从记录到洞察的闭环。
4. 命令行效率优势：相较于移动端应用的界面操作，CLI 方式更适合批量数据处理和自动化脚本集成，满足进阶用户的高效工作流需求。
5. 隐私保护到位：用户数据完全由本地 CLI 工具处理，Skill 本身不接触、不存储、不传输任何个人信息，符合 GDPR 数据最小化原则。
潜在缺点与局限性
1. 订阅门槛限制：必须拥有 Hevy Pro 订阅才能获取 API 密钥，免费用户无法使用，且 Skill 本身不提供替代数据源。
2. 前置依赖复杂：需用户自行安装 Go 环境、hevycli 工具并完成 API 配置，技术门槛对非开发者用户不够友好。
3. 只读功能限制：Skill 和底层 CLI 均仅支持数据查询和导出，无法创建、修改或删除训练记录，用户需返回 Hevy 应用进行数据管理。
4. 分页限制约束：API 单次最大返回 10 条记录，历史数据较多时需多次分页调用，批量导出效率受限。
5. 单位固定不可调：重量强制使用千克、距离使用米，习惯英制单位的用户需自行转换。
适合的目标群体
1. 量化健身爱好者：习惯用数据驱动训练决策，希望追踪长期进步曲线的严肃训练者。
2. 开发者与技术用户：熟悉命令行操作，希望将健身数据集成到个人数据管道或自动化工作流中的技术人员。
3. 健身教练与数据分析师：需要批量导出学员训练数据，进行跨周期对比和计划优化的专业人士。
4. 平台迁移需求者：希望将 Hevy 数据导出为标准化 JSON，迁移至其他健身管理工具或自建系统的用户。
使用风险提醒
1. 第三方工具安全风险：Skill 依赖的外部 hevycli 工具非 Skill 自身可控，用户应从 GitHub 官方仓库（github.com/nsampre/hevycli）安装，避免使用来路不明的预编译二进制文件。
2. API 密钥管理：用户配置的 Hevy API 密钥存储于本地 hevycli 配置中，需妥善保管避免泄露，Skill 建议定期轮换密钥。
3. 数据时效性：Skill 仅反映 Hevy 平台的实时数据状态，历史导出文件不会自动同步更新，分析时需注意数据版本。
4. 服务连续性依赖：Hevy Pro 订阅状态、Hevy API 可用性及 hevycli 工具的维护状态均影响 Skill 的实际可用性，存在外部服务中断风险。