用途:这是 Run-Smart 系列跑步教练 AI 技能的参考目录,定义所有技能共用的约定、契约、安全姿态与遥测规范,让 Claude 能发现可用技能及其遵循的规则。
主要能力:提供共享参考文件,包括契约(running-coach-index/references/contracts.md)、遥测(telemetry.md)、约定(conventions.md)和冒烟测试(smoke-tests.md)。
使用方式:在调用任何 Run-Smart 技能前先加载本索引以理解共享 schema、安全指引与遥测;接入新技能时用于确保符合通用契约;按用户需求选择对应技能目录(计划生成、调整、洞察等);用 contracts.md 及技能专属 schema 校验请求/响应负载。
集成点:技能从聊天流程(v0/app/api/chat/route.ts、v0/lib/enhanced-ai-coach.ts)、计划生成 API(v0/app/api/generate-plan/route.ts)、后台任务(计划调整)和跑后界面调用。
标准遥测事件:ai_skill_invoked、ai_plan_generated、ai_adjustment_applied、ai_insight_created、ai_safety_flag_raised、ai_user_feedback。
安全与护栏:不做医疗诊断;若出现疼痛、头晕或严重症状,建议停止活动并咨询合格专业人士;不确定时优先采取保守调整;阈值被触发时发出 SafetyFlag 对象并通过 ai_safety_flag_raised 记录。
限制:资料未提供具体 schema 字段、阈值数值、安装命令或收费信息。