# AI 质量改进项执行动作继承 RAG 上下文记录

日期：2026-06-25

## 背景

上一轮已经完成“AI Trace RAG explain -> 质量改进项”的上下文打通。本轮继续推进质量改进闭环：管理员在质量改进项详情页执行“创建 Prompt 草稿”或“写入知识库并关联”时，系统应该自动复用 Trace 带来的 RAG 线索，减少人工整理。

## 本轮目标

- 从质量改进项的 `description` 和 `root_cause_hint` 中提取可执行线索。
- 执行动作区展示即将带入草稿的关键上下文。
- Prompt 草稿自动带入：
  - 来源问题
  - 检索词
  - 未命中词
  - 可引用依据
  - 低分或被过滤候选
  - fallback/provider 异常
- 知识库补充草稿自动带入：
  - 未命中词
  - 问题判断
  - 需要补充或核验的依据
  - 已入选但需要复核引用的依据

## 已完成内容

### 改进项详情页执行区增强

文件：

- `yuqei-contract-platform/apps/contract-web/src/app/admin/ai-quality-dashboard/[actionId]/quality-action-detail-client.tsx`

完成点：

- 新增 `ActionContextSummary`。
- 新增 `parseActionContextSummary`，从改进项上下文中解析：
  - `question`
  - `retrievalQuery`
  - `unmatchedTerms`
  - `includedEvidence`
  - `filteredCandidates`
  - `fallbackLine`
- 新增执行前上下文预览 `ExecutionContextPreview`。
- `defaultKnowledgeDraft` 改为生成带 RAG 线索的知识库补充草稿。
- `buildPromptDraftContent` 改为生成带 RAG 诊断信息的 Prompt 草稿。

### 样式增强

文件：

- `yuqei-contract-platform/apps/contract-web/src/app/globals.css`

完成点：

- 新增执行上下文预览样式。
- 保持执行按钮仍是主动作，线索预览作为辅助信息，不增加复杂流程。

## 验证结果

已通过：

```powershell
npm run web:typecheck
npm run web:build
git diff --check
```

## 当前闭环

当前链路为：

1. AI Trace 保存 RAG explain。
2. Trace 详情根据质量标签生成改进项，并带入 RAG 诊断上下文。
3. 改进项详情页展示问题上下文。
4. 管理员直接执行 Prompt 草稿或知识库补充。
5. 草稿自动继承未命中词、低分候选、过滤原因和可引用依据。

这保持了 V2 方案的边界：AI 中台负责 RAG、审计、质量评测和改进动作；合同业务系统不处理模型、Prompt、知识库细节。