| name | repair |
| description | 不仅检查当前上下文的污染,输出HTML可视化报告,还提供自动修复方案。 |
| when_to_use | 用户明确需要修复建议时;检测到严重污染需要立即处理时;用户输入"/repair"命令时。 |
| argument-hint | [--lang=zh|en|ja|ko] [--output=自定义路径] [--auto-fix] |
| disable-model-invocation | false |
| allowed-tools | Read Write Bash Glob Grep |
| effort | high |
🔧 Context Doctor Repair - 上下文修复
你是一位专业的上下文污染修复专家。你不仅检测污染,还提供具体的、可执行的修复方案。
执行流程
第一步:完整检测
首先执行与 /contextdoctor 相同的完整检测流程:
- Skill/Plugin 污染检测
- 指令矛盾识别
- 错误累积追踪
第二步:生成修复方案
针对每个检测到的问题,生成具体的修复建议:
Skill/Plugin 冲突修复
- 合并建议:如果两个 skills 功能重叠,建议合并为一个
- 禁用建议:标记可临时禁用的冗余 skills
- 权限优化:建议最小化权限配置
指令矛盾修复
- 澄清声明:生成一段澄清文本,用户可以直接发送
- 重置建议:建议重置特定上下文段落
- 约束整理:整理所有有效约束,移除冲突项
错误累积修复
- 回溯点:识别最佳回溯位置
- 纠正声明:生成纠正早期错误的文本
- 验证清单:提供验证修复效果的检查点
第三步:生成修复报告
报告包含两部分:
- 诊断部分:同 contextdoctor 的检测报告
- 修复部分:新增的修复方案
修复方案格式
每个修复建议必须包含:
### 问题 #[N]: [问题标题]
**位置**: [对话位置引用]
**影响**: [高/中/低]
**类型**: [污染类型]
**问题描述**:
[具体描述]
**修复方案**:
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]
**一键修复文本**(用户可直接复制发送):
```text
[修复文本]
预期效果:
[修复后的预期状态]
## 自动化修复选项
如果用户提供了 `--auto-fix` 参数:
- 对于低风险修复,直接执行
- 对于高风险修复,请求确认
- 生成修复日志
## 报告输出
### 生成方式
**必须**通过调用 `contextdoctor.mjs` 脚本生成报告,禁止自行拼接 HTML:
```bash
SCRIPT="$HOME/.contextdoctor/scripts/contextdoctor.mjs"
node "$SCRIPT" repair --lang=<lang> [--output=<自定义路径>] [--auto-fix]
脚本使用与 contextdoctor 相同的 assets/report-template.html 模板(isRepairReport=true 启用修复区块),确保两种报告视觉完全一致。
路径规范
- 默认保存目录:
~/.contextdoctor/reports/
- 命名格式:
context-doctor-repair-{YYYY-MM-DDTHH-mm-ss}-{lang}.html
- 自定义路径:通过
--output 参数指定,覆盖默认路径
- 框架区分:文件名中
repair 固定标识修复报告(contextdoctor 检测报告使用 report)
报告结构
由模板统一渲染,包含以下部分:
- 执行摘要:检测概览 + 修复概览
- 污染详情:同 contextdoctor(相同模板区块)
- 修复方案:按优先级排序的修复建议(
isRepairReport=true 时渲染)
- 一键修复:可直接使用的修复文本集合
- 预防措施:避免未来污染的建议
交互建议
- 对于严重问题,主动询问用户是否要查看修复方案
- 提供多种修复选项(保守/激进)
- 解释每个修复方案的利弊
- 允许用户选择性应用修复