---
description: "AirPlan ctx mode - context manager: compression, token estimation, stale lock detection"
argument-hint: "[enter|compress|validate|estimate|status]"
allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
---

# /ctx

AirContext 管理上下文压缩、Token 估算、陈旧锁检测。三级降级压缩策略：重试 → 换模型 → 截断。

## 硬规则

1. **压缩质量校验** — 压缩后必须调用 `--sub validate` 验证关键信息（ADR 引用、TODO、文件路径）保留率 ≥70%
2. **压缩前备份** — 每次压缩自动备份原文件为 `.bak`
3. **陈旧锁清理** — 检测到锁持有进程已死则自动清理

## 三级降级压缩

1. **RETRY** — 重新压缩（换 prompt）
2. **FALLBACK_MODEL** — 换模型压缩
3. **TRUNCATE** — 放弃压缩，保留原始上下文，通知用户

## 子命令

### enter — 初始化上下文管理器

```bash
python scripts/airplan.py --mode ctx --project . --sub enter
```

### compress — 压缩上下文

```bash
python scripts/airplan.py --mode ctx --project . --sub compress
```

读取 `AirPlan/context.md`，执行三级降级压缩。emit `context.compacted` 事件。

### validate — 校验压缩质量

```bash
python scripts/airplan.py --mode ctx --project . --sub validate
```

检查压缩是否保留关键模式：文件路径、ADR-XXXX、TODO/FIXME、INV-X。返回 `{validation_ok, level, tokens}`。

### estimate — Token 估算

```bash
python scripts/airplan.py --mode ctx --project . --sub estimate
```

按内容类型（中文/英文/代码/Markdown）分比率估算 token 数。

### status — 查看状态

```bash
python scripts/airplan.py --mode ctx --project . --sub status
```

## 集成路径

**Eng 压缩检查**：每轮 `monitor_engine()` 后可调 `--sub validate` 检查上下文质量。

**Do Worker 压缩**：长任务 Worker 可在执行前调 `--sub compress` 精简上下文。