team-repair 是面向 team-ai-directives 仓库的索引修复技能。用途是在索引不一致、检测到孤立文件、批量修改 team-ai-directives 之后，或需要周期性校验指令健康状况时使用；输入为 team-ai-directives 仓库。
主要能力：先执行 Phase 0 健康检查（校验指令框架已安装配置、上下文模块存在、技能注册表、OKF 日志跟踪、宪法对齐、OKF v0.2 type 字段、项目 AGENTS.md 指令、确定性强制覆盖、adlc 孤立分支等检查），任一检查返回 [FAIL] 则中止修复。随后重建各目录 index.md（OKF §8）与 log.md（OKF §9），从 index.md 派生 CDR.md 扁平表（供 team-boot 系统提示注入），从 skills/ 重建 .skills.json，为孤立上下文模块自动补充 OKF v0.2 YAML frontmatter，为孤立技能自动生成 .skills.json 条目，并修复或注入 AGENTS.md；每次运行都会将 OKF v0.1 frontmatter 迁移到 v0.2（always-on，无法关闭）。此外可做规则冲突扫描与时效验证。
使用方式：以参数调用，空参数执行全部索引修复并自动修复（含 v0.1 到 v0.2 迁移）。可用参数包括 --dry-run（仅报告不写入）、--health-only、--validate、--conflicts、--freshness、--build-to-delete、--validate-drafts（只读校验草稿）、--update-confidence、--ensure-adlc、--index-only、--skills-only、--agents-only。修复前需确保 TEAM_AI_DIRECTIVES 已配置，否则提示运行 /team-setup 或设置环境变量。路径由 team-setup 下的 team-helpers.sh --json 解析。
限制：资料未提供收费、价格、平台支持范围或性能数据；健康检查失败时不得继续修复。