名称： workout
描述： 使用 workout-cli 记录训练、记录组数、管理动作和模板。支持多用户配置文件。适用于帮助用户记录健身训练、查看历史或分析力量进展。
元数据： {"clawdbot":{"emoji":"🏋️","requires":{"bins":["workout"]}}}

Workout CLI

多用户配置文件

多人可以使用独立的配置文件来记录各自的训练。

workout profile list               # 列出所有配置文件
workout profile create sarah       # 创建新配置文件
workout profile delete old         # 删除配置文件

当存在多个配置文件时，请指定使用哪一个：

workout --profile mike start push-day
workout --profile mike log bench-press 185 8
workout --profile mike done

• 单一配置文件：命令无需 --profile 即可工作（向后兼容）
• 共享动作库：动作库在所有配置文件间共享
• 用户专属数据：模板、训练记录、配置为每个配置文件独立存储

关键规则

1. 始终先添加新动作

如果用户提到的动作不在库中，请在记录前先添加它：

workout exercises add "哑铃罗马尼亚硬拉" --muscles hamstrings,glutes --type compound --equipment dumbbell

切勿跳过此步骤——未知动作将无法记录。

2. 记录准确的数字——备注不能替代

记录组数需要正确的重量和次数。这些数字用于统计分析（个人记录、训练量、进展）。
- ❌ 错误做法：记录 0 磅，然后在备注中说明真实重量
- ✅ 正确做法：记录实际使用的重量

如果用户未指定重量，请在记录前询问。不要假设为 0。

3. 备注仅用于元数据

使用备注记录背景信息（如伤病、动作提示、器械说明），而不是用来修正错误数据：

workout note "今天左肘不适"
workout note bench-press "使用窄握距"

核心命令

workout start --empty              # 开始自由训练
workout start push                 # 从模板开始训练
workout log bench-press 135 8      # 记录一组（重量 次数）
workout log bench-press 135 8,8,7  # 记录多组
workout note "训练备注"             # 添加备注
workout note bench-press "备注"     # 为特定动作添加备注
workout swap bench-press db-bench  # 替换动作
workout done                       # 完成训练
workout cancel                     # 取消训练

编辑与修正已记录的组数

workout undo                       # 移除最后记录的一组
workout undo bench-press           # 移除特定动作的最后记录的一组
workout edit bench-press 2 155 8   # 编辑第 2 组：重量=155，次数=8
workout edit bench-press 2 --reps 10 --rir 2  # 编辑次数和保留次数
workout delete bench-press 3       # 完全删除第 3 组

组数编号从 1 开始。在训练过程中使用这些命令来修正错误。

动作管理

workout exercises list
workout exercises list --muscle chest
workout exercises add "动作名称" --muscles biceps --type isolation --equipment cable

⚠️ exercises add 命令需要参数：--muscles、--type、--equipment

器械选项：barbell, dumbbell, cable, machine, bodyweight, kettlebell, band, other

模板

workout templates list
workout templates show push
workout templates create "推举日" --exercises "bench-press:4x8,ohp:3x8"

历史记录与个人最佳

workout last                       # 上一次训练
workout history bench-press        # 动作历史记录
workout pr                         # 所有个人最佳
workout pr bench-press             # 特定动作的个人最佳
workout volume --week              # 周训练量
workout progression bench-press    # 随时间进展

典型训练流程

# 1. 开始训练
workout start push

# 2. 使用真实数字记录
workout log bench-press 135 8
workout log bench-press 145 8
workout log bench-press 155 6

# 3. 仅用于背景信息的备注
workout note bench-press "今天感觉状态很好"

# 4. 完成训练
workout done

器械变式

使用特定的动作名称来正确记录器械变式：
- bench-press (杠铃) 对比 dumbbell-bench-press
- romanian-deadlift (杠铃) 对比 dumbbell-rdl
- shoulder-press (杠铃) 对比 dumbbell-shoulder-press

注意事项

• 重量单位为 磅
• 可以多次使用 log 命令记录不同重量
• swap 命令会将所有已记录的组数转移到新动作下
• 所有命令都支持 --json 参数