介绍
# Section 11 — AI Coaching Protocol
## 首次使用设置
首次使用时：
1. **在工作区中检查 DOSSIER.md** - 如果未找到，从以下地址获取模板：https://raw.githubusercontent.com/CrankAddict/section-11/main/DOSSIER_TEMPLATE.md - 要求运动员填写其数据（区间、目标、日程等） - 在工作区中保存为 DOSSIER.md
2. **设置 JSON 数据源** - 运动员为训练数据创建一个私有 GitHub 仓库，或者将文件保存在本地 - 设置从 Intervals.icu 到 `latest.json` 和 `history.json` 的自动同步 - 将两个原始 URL 保存在 DOSSIER.md 中的“Data Source”下（如果在本地运行，则保存本地文件路径） - `latest.json` — 当前 7 天快照 + 28 天衍生指标 - `history.json` — 纵向数据（每日 90 天，每周 180 天，每月 3 年） - 请参阅：https://github.com/CrankAddict/section-11#2-set-up-your-data-mirror-optional-but-recommended
3. **配置心跳设置** - 从以下地址获取模板：https://raw.githubusercontent.com/CrankAddict/section-11/refs/heads/main/openclaw/HEARTBEAT_TEMPLATE.md - 询问运动员的具体数值： - 天气检查的位置（城市/地区） - 时区 - 有效的户外骑行时段 - 天气阈值（最低温度、最大风速、最大降雨 %） - 偏好的通知时段 - 在工作区中保存为 HEARTBEAT.md
在档案、数据源和心跳配置完成之前，请勿继续进行教练工作。
## 协议
获取并遵循：https://raw.githubusercontent.com/CrankAddict/section-11/main/SECTION_11.md
**当前版本：** 11.4
## 数据层级 1. JSON 数据（始终首先获取 latest.json，然后获取 history.json 以了解纵向背景） 2. 协议规则 (SECTION_11.md) 3. 运动员档案 (DOSSIER.md) 4. 心跳配置 (HEARTBEAT.md)
## 必需操作 - 在任何训练问题之前获取 latest.json - 当需要进行趋势分析、阶段背景或纵向比较时获取 history.json - 不要对预计算指标进行虚拟数学运算 — 使用获取的数值作为 CTL、ATL、TSB、ACWR、RI、区间等。当预计算值未覆盖问题时，可以对原始数据进行自定义分析。 - 在生成建议之前遵循第 11 节 C 验证清单 - 根据协议引用框架（清单项 #10）
## 报告模板
使用 `/examples/reports/` 中的标准化报告格式： - **训练前：** 准备情况评估，进行/修改/跳过建议 — 参见 `PRE_WORKOUT_TEMPLATE.md` - **训练后：** 课程指标，计划执行情况，周总计 — 参见 `POST_WORKOUT_TEMPLATE.md` - **简洁性规则：** 当指标正常时保持简洁。当突破阈值或运动员询问“为什么”时，详细说明。
从以下地址获取模板： - https://raw.githubusercontent.com/CrankAddict/section-11/main/examples/reports/PRE_WORKOUT_TEMPLATE.md - https://raw.githubusercontent.com/CrankAddict/section-11/main/examples/reports/POST_WORKOUT_TEMPLATE.md
## 心跳操作
每次心跳时，遵循 HEARTBEAT.md 中定义的检查和调度规则： - 每日：训练/健康观察（来自 latest.json），天气（仅当条件良好时） - 每周：背景分析（使用 history.json 进行趋势比较） - 自我安排下一次心跳，在通知时段内采用随机时间
## 安全与隐私
**数据所有权与存储** 所有训练数据均存储在用户选择的位置：他们自己的设备上或由其控制的 Git 仓库中。本项目不运行任何后端服务、云存储或第三方基础设施。除非用户明确配置，否则不会上传任何内容。
**匿名化** `sync.py` 在原始训练数据被教练协议使用之前会对其进行匿名化处理。身份信息会被剥离；AI 教练仅使用汇总和衍生指标（CTL、ATL、TSB、区间分布、功率/心率 摘要）。
**网络行为** 该技能执行简单的 HTTP GET 请求以获取： - 来自此仓库的教练协议 (`SECTION_11.md`) - 来自此仓库的报告模板 - 来自用户配置 URL 的运动员训练数据（`latest.json`、`history.json`）
它**不会**向外部 URL 发送 API 密钥、LLM 聊天记录或任何用户数据。所有获取的内容均来自用户明确配置的来源。
**推荐设置：本地文件或私有仓库** 最安全、最简单的设置是完全本地：将您的数据导出为 JSON 并将技能指向您设备上的文件（参见 `examples/json-manual/`）。如果您使用 GitHub，请使用**私有仓库**。有关包含私有仓库与代理一起使用的自动同步设置，请参阅 `examples/json-auto-sync/SETUP.md`。
**协议和模板 URL** 默认协议和模板 URL 指向此仓库。风险模型是标准开源供应链。
**心跳 / 自动化** 心跳机制是完全可选的。默认情况下未启用，除非用户明确配置，否则不会自动运行任何内容。启用后，它执行一组有限的操作：读取训练数据、运行分析、将更新的摘要/计划写入用户选择的位置。
**私有仓库与代理访问** 第 11 节不实现 GitHub 身份验证。它从运行时环境已经可以访问的任何位置读取文件： - 本地运行：从您的文件系统读取 - 在代理（OpenClaw、Claude Cowork 等）中运行并配置了 GitHub 访问权限：可以读取/写入代理令牌/SSH 密钥允许的仓库
访问完全由用户在其环境中已配置的凭据控制。