running-coach-index
所有跑步教练AI技能的参考目录,共享TypeScript合约、安全防护线和遥测规范。在处理任何跑步教练功能时使用,以了解数据架构、安全模式或集成点。
📖 中文导读:所有跑步教练AI技能的参考目录,共享TypeScript合约、安全防护线和遥测规范。在处理任何跑步教练功能时使用,以了解数据架构、安全模式或集成点。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: running-coach-index description: Reference catalog for all running coach AI skills, shared TypeScript contracts, safety guardrails, and telemetry conventions. Use when working with any running coach feature to understand data schemas, safety patterns, or integration points. metadata: short-description: Catalog of AI skills, contracts, telemetry, and guardrails for Run-Smart.
Purpose
Defines the shared conventions, contracts, safety posture, and telemetry used by all Run-Smart AI skills. This index allows Claude to discover available skills and the rules they follow.
When Claude should use this skill
- Before invoking any Run-Smart skill to understand shared schemas, safety guidance, and telemetry
- When onboarding a new skill to ensure compliance with common contracts
- When working with running coach features and need to understand data schemas or safety patterns
Invocation guidance
- Load shared references in
running-coach-index/references/(contracts, telemetry, conventions, smoke-tests). - Select the appropriate skill directory based on the user's need (plan generation, adjustment, insights, etc.).
- Validate request/response payloads against the schemas in
contracts.mdand skill-specific schemas.
Shared components
- Contracts:
running-coach-index/references/contracts.md - Telemetry:
running-coach-index/references/telemetry.md - Conventions:
running-coach-index/references/conventions.md - Smoke tests:
running-coach-index/references/smoke-tests.md
Safety & guardrails
- No medical diagnosis. If pain/dizziness/severe symptoms appear, advise stopping activity and consulting a qualified professional.
- Prefer conservative adjustments under uncertainty.
- Emit
SafetyFlagobjects when thresholds are crossed and log viaai_safety_flag_raised.
Integration points
- Skills are invoked from chat flows (
v0/app/api/chat/route.ts,v0/lib/enhanced-ai-coach.ts), plan generation APIs (v0/app/api/generate-plan/route.ts), background jobs (plan adjustment), and post-run screens.
Telemetry events (standard)
ai_skill_invokedai_plan_generatedai_adjustment_appliedai_insight_createdai_safety_flag_raisedai_user_feedback