108 lines
4.1 KiB
Markdown
108 lines
4.1 KiB
Markdown
# 课评质检系统集成方案
|
||
|
||
## 背景
|
||
|
||
橙子有一个独立的「课评质检系统」项目（位于 `课评质检系统/` 目录），包含9个质检Agent，用于检查课评质量。需要将其集成到现有的课评生成流程中，实现生成课评后自动质检。
|
||
|
||
## 目标
|
||
|
||
1. 将9个质检Agent复制到 `.claude/agents/` 目录
|
||
2. 修改课评生成技能，在生成课评后自动调用质检
|
||
3. 保持现有流程不变，只在"生成"和"确认"之间插入质检环节
|
||
|
||
## 实施步骤
|
||
|
||
### 步骤1：复制质检Agent文件
|
||
|
||
将 `课评质检系统/agents/` 目录下的9个Agent文件复制到 `.claude/agents/` 目录：
|
||
|
||
```
|
||
课评质检系统/agents/ → .claude/agents/
|
||
├── feedback-evidence-auditor.md ├── 课评证据审计员/agent.md
|
||
├── feedback-quality-reviewer.md ├── 课评质量评审员/agent.md
|
||
├── feedback-final-editor.md ├── 课评终稿编辑/agent.md
|
||
├── feedback-review-orchestrator.md ├── 课评质检调度器/agent.md
|
||
├── parent-busy-pragmatic.md ├── 家长-忙碌实用型/agent.md
|
||
├── parent-result-oriented.md ├── 家长-结果导向型/agent.md
|
||
├── parent-detail-oriented.md ├── 家长-细节核对型/agent.md
|
||
├── parent-anxious-safety.md ├── 家长-焦虑保护型/agent.md
|
||
└── parent-growth-partner.md └── 家长-成长陪伴型/agent.md
|
||
```
|
||
|
||
每个Agent创建独立目录，包含 `agent.md` 文件。
|
||
|
||
### 步骤2：创建质检调度器Agent
|
||
|
||
创建一个新的调度器Agent `课评质检调度器/agent.md`，用于协调9个Agent的工作流程：
|
||
|
||
**职责**：
|
||
- 接收待质检的课评内容
|
||
- 并行调用证据审计员、质量评审员、5位家长
|
||
- 汇总结果，调用终稿编辑产出修订稿
|
||
- 输出质检报告 + 修订稿
|
||
|
||
### 步骤3：修改课评生成技能
|
||
|
||
修改 `.claude/skills/课评生成/SKILL.md`，在步骤6（生成班级总结）和步骤7（确认流程）之间插入质检步骤：
|
||
|
||
**新增步骤6.5：课评质检**
|
||
|
||
```
|
||
6.5 课评质检（自动生成后自动执行）
|
||
对生成的班级总结和个人课评，调用课评质检系统进行质检：
|
||
- 调用「课评质检调度器」Agent
|
||
- 输入：班级总结 + 所有学生的个人课评
|
||
- 输出：质检报告 + 修订稿
|
||
- 如果质检结论为"必须重写"，自动修订后再次质检（最多2轮）
|
||
- 如果质检结论为"修订后发送"，使用修订稿替换原稿
|
||
- 如果质检结论为"直接发送"，保持原稿
|
||
- 质检报告附在课评后面，供橙子参考
|
||
```
|
||
|
||
### 步骤4：更新CLAUDE.md
|
||
|
||
在CLAUDE.md的「标准工作流程」中增加质检环节说明：
|
||
|
||
```markdown
|
||
6. **课评质检**：自动调用课评质检系统检查课评质量，输出质检报告+修订稿
|
||
7. **保存归档**：...
|
||
```
|
||
|
||
### 步骤5：创建质检技能说明
|
||
|
||
在 `.claude/skills/` 目录下创建 `课评质检/SKILL.md`，作为质检的独立技能入口，支持手动触发质检：
|
||
|
||
```markdown
|
||
---
|
||
name: 课评质检
|
||
description: 对已有课评进行质量检查，输出质检报告和修订稿
|
||
type: skill
|
||
---
|
||
|
||
# 课评质检技能
|
||
|
||
## 触发方式
|
||
- 课评生成流程中自动触发
|
||
- 手动触发："用课评质检系统检查这份课评：[贴课评]"
|
||
|
||
## 执行流程
|
||
1. 调用「课评证据审计员」核对事实
|
||
2. 调用「课评质量评审员」打分+硬伤检查
|
||
3. 并行调用5位家长Agent评阅读体验
|
||
4. 调用「课评终稿编辑」产出修订稿
|
||
5. 输出质检报告+修订稿
|
||
```
|
||
|
||
## 验证方式
|
||
|
||
1. **单元验证**：单独调用每个Agent，确认能正常工作
|
||
2. **集成验证**：用一份真实课评测试完整质检流程
|
||
3. **流程验证**：跑一次完整的课评生成流程，确认质检环节自动触发
|
||
|
||
## 注意事项
|
||
|
||
1. 保持现有流程不变，质检是新增环节，不替代任何现有步骤
|
||
2. 质检报告供参考，最终决定权在橙子
|
||
3. CSP班级的OJ数据核对是质检的重点，证据审计员会重点检查
|
||
4. 质检最多自动修订2轮，避免无限循环
|