docs: 全部 12 个命令文件完整化 — 消除 P0/P1 操作歧义
P0: 9 个存根命令文件从 11 行模板扩展为完整操作文档 - dbg: 7 步工作流表格 + 证据类型 + 子命令 + Dbg↔Do 集成路径 - ctx: 三级降级压缩 + 质量校验 + Token 估算 + 陈旧锁清理 - dep: SSH 部署流程 + MD5 校验 + systemd 管理 - tst: 5 种测试框架 + run 命令 + T-TEST 集成 - sec: advisory/blocking 双模式 + 文件/目录/Woker result 三种扫描 - rvr: 审查模式 + highRiskAudit + code-to-design + Eng merge 集成 - sdb: 6 种后端 + diff 模式 + Dbg 取证集成 - ndb: 网络抓包 + Dbg 取证集成 - xdb: kmsgrab/xvfb/fallback 三后端 + Dbg/Do GUI 验证集成 P1: 3 个有内容文件的歧义修复 - do: AirDbg 路由具体命令 + 证据采集(xdb/ndb/sdb/tst)命令 - arc: 三阶段→命令映射表 + phase 推进方式 - eng: monitor 轮询循环伪代码(Agent 无时钟概念,必须循环调 monitor) 全部命令统一使用 `python scripts/airplan.py` 路径(清除旧 $HOME/plugins 引用) 63 项功能测试全通过 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -1,11 +1,65 @@
|
||||
---
|
||||
description: "AirPlan ctx mode"
|
||||
argument-hint: "[enter|status|...]"
|
||||
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
|
||||
|
||||
Run AirPlan ctx mode.
|
||||
AirContext 管理上下文压缩、Token 估算、陈旧锁检测。三级降级压缩策略:重试 → 换模型 → 截断。
|
||||
|
||||
python "$HOME/plugins/airplan/scripts/airplan.py" --mode ctx --project . [OPTIONS]
|
||||
## 硬规则
|
||||
|
||||
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` 精简上下文。
|
||||
|
||||
Reference in New Issue
Block a user