| name | rpa-student-multi-agent-system |
| description | RPA学生多智能体作业系统总控Skill：统一调度三大子智能体（老师/破障/资产），覆盖有源码改作业、无源码做新作业双场景。当用户需要完成RPA作业、处理源码ID风险、框选操作教学、从零生成作业时触发。根据用户需求自动路由到对应的子智能体。 |
RPA 学生多智能体作业系统（总控 Skill）
系统概述
本系统由 三大子智能体 协作完成 RPA 课程作业的全流程处理，覆盖「有源码改作业」和「无源码做新作业」两大完整场景。系统设计遵循三大硬性强制规则：ID 零硬编码、ID 自主提交、框选必交底。
三大子智能体对照表
| 子智能体 | Skill 名称 | 核心职责 | 触发关键词 |
|---|
| 老师教学智能体 | rpa-teacher-agent | 框选标准化教学、作业合规指导、考点讲解、ID 合规教育 | 框选、教学、怎么操作、不会、验收标准 |
| 破障修复智能体 | rpa-crack-agent | 清除硬编码 ID、ID 合法性校验、风控检测、动态注入 | 别人 ID、清除、Base64、风控、串号 |
| 模块资产智能体 | rpa-module-asset-agent | 资产库管理、模板生成、路径适配、素材补齐 | 缺素材、路径不对、补表格、生成作业 |
路由判断表
当用户输入需求时，系统根据以下规则判断用户意图，自动路由到对应的子智能体：
| 用户说... | 路由到 | 处理流程 |
|---|
| "帮我完成 RPA 作业"、"有源码要改"、"别人分享的代码" | 破障 Agent -> 资产 Agent -> 老师 Agent | 全流程串行处理 |
| "没有代码"、"从零开始"、"不会写 RPA" | 资产 Agent -> 老师 Agent -> 破障 Agent | 全流程串行处理 |
| "怎么框选"、"框哪里"、"框选教学" | 老师 Agent | 仅调用老师教学 |
| "代码里有别人 ID"、"清除 ID"、"Base64" | 破障 Agent | 仅调用破障处理 |
| "补素材"、"路径不对"、"缺表格" | 资产 Agent | 仅调用资产处理 |
| "帮我检查作业"、"有风险吗"、"能提交吗" | 破障 Agent -> 老师 Agent | 校验 + 验收 |
| "作业答案"、"给我代码" | 老师 Agent | 教学指导，不直接给答案 |
| "帮我看看这个错误" | 老师 Agent -> 破障 Agent | 先诊断再修复 |
双场景工作流
场景 A：有同学分享源码工程
Step1 破障 Agent -> 全自动扫描清除他人 Base64 硬编码 ID
清空 auth/token/task_id/user_id 等字段
Step2 资产 Agent -> 检测缺失素材、自动补齐表格/图片/依赖
批量替换本机路径
Step3 老师 Agent -> 讲解框选逻辑、区域位置、功能作用
输出框选对照表
Step4 用户自主填写本机 UserID、TaskID
Step5 CORE_RUNTIME -> 动态注入用户个人 ID
生成专属合规作业（无风控、无查重）
场景 B：无任何源码（从零做作业）
Step1 资产 Agent -> 从资产库调用标准代码模板 + 配套表格 + 图片素材
自动适配本机路径
Step2 老师 Agent -> 逐步骤输出手动框选指导方案
明确告知：点哪里、框哪个区域、范围多大、对应什么功能
Step3 用户按照指导完成页面框选、元素拾取操作
Step4 CORE_RUNTIME -> 记录框选行为 -> 生成操作记录文档
Step5 用户强制提交个人 UserID、TaskID（不提交不生成）
Step6 破障 Agent -> 校验 ID 合法性 -> 动态注入工程
最终输出可直接提交的合规作业
三大硬性强制规则
规则 1：ID 零硬编码
系统中所有模板、脚本、配置文件，永久不内置任何 UserID/TaskID，不预埋 Base64 编码。所有 ID 字段使用 {{USER_ID}}、{{TASK_ID}} 占位符。任何代码文件不得包含真实学生 ID 的明文或编码形式。
违规后果：一旦检测到硬编码 ID，作业直接判定为不合规，系统拒绝继续生成/修改。
规则 2：ID 自主提交
最终作业生成前，必须由用户手动输入个人本机学生版 ID。系统只做运行时动态注入到 os.environ 环境变量（仅内存，不落盘），不伪造、不替换、不篡改。
正确流程：用户从学生平台获取专属 ID -> 在 USER_WORKSPACE/user_id_config.yaml 中填写 -> 运行时注入 -> 验证 -> 提交。
规则 3：框选必交底
所有需要手动框选、拾取元素的步骤，必须向用户输出「位置 + 范围 + 功能 + 对错标准」，不允许只给代码不给操作说明。每处框选必须包含：
- 框选位置：xx 页面 -> xx 区域 -> xx 元素
- 框选范围：从 (x1,y1) 到 (x2,y2)
- 选中元素类型：表格 / 按钮 / 输入框 / 图片
- 实现功能：用于 xxx 操作
- 选错扣分点：若框选范围过大 / 过小会扣 xx 分
系统架构
f:\RPA(1)\rpa-student-multi-agent-system/
├── SKILL.md <- 总控 Skill（本文件）
├── SYSTEM_README.md <- 系统完整说明文档
│
├── ASSET/ <- 全局作业资产库
│ ├── excel_template/ <- Excel 业务数据表索引
│ ├── img_asset/ <- 图片资产索引
│ ├── py_base_template/ <- Python 标准代码模板
│ └── homework_history/ <- 历史作业归档
│
├── REFERENCE/ <- 全局参考文档
│ ├── course_rule.md <- 课程考核规则
│ ├── error_summary.md <- 常见错误汇总
│ ├── ui_element_lib.md <- UI 元素选择器参考库
│ └── ui_guide/ <- 框选操作指南
│ ├── 01_框选区域位置说明.md
│ ├── 02_框选对应功能详解.md
│ ├── 03_正确框选范围标准.md
│ └── 04_常见框选错误扣分点.md
│
├── SCRIPTS/ <- 全局可执行核心脚本
│ ├── asset_exists_check.py <- 资产存在性检查
│ ├── asset_auto_copy.py <- 资产自动复制
│ ├── path_batch_replace.py <- 批量路径替换
│ ├── runtime_id_input.py <- 运行时 ID 注入
│ ├── path_auto_fix.py <- 路径智能修复
│ └── safe_retry.py <- 安全重试机制
│
├── AGENTS/ <- 三大细分智能体
│ ├── agent_teacher/ <- 老师教学智能体
│ │ └── SKILL_TEACH.md
│ ├── agent_fix_crack/ <- 破障修复智能体
│ │ ├── SKILL_FIX.md
│ │ ├── id_safe_refactor.py
│ │ └── risk_check.py
│ └── agent_module_asset/ <- 模块资产智能体
│ └── SKILL_ASSET.md
│
└── USER_WORKSPACE/ <- 用户工作区
├── user_id_config.yaml <- 用户 ID 配置模板
└── select_record.md <- 框选操作记录模板
依赖检查清单
系统正常运行依赖以下前置条件，启动时须逐一检查：
| # | 检查项 | 检查内容 | 通过标准 |
|---|
| 1 | 资产根目录 | f:\RPA(1)\ 是否存在 | 目录存在 |
| 2 | 机器人文件夹 | 7 个机器人文件夹是否完整 | 全部存在 |
| 3 | 业务表格 | 8 个 .xls 数据表是否存在 | 全部存在 |
| 4 | 图片素材 | 19 张 PNG 截图是否存在 | 全部存在 |
| 5 | Python 环境 | Python 3.x 是否可用 | python --version 成功 |
| 6 | 依赖组件 | 各机器人的 dependencies/ 组件是否存在 | rpaproj + rpax 完整 |
| 7 | 用户工作区 | USER_WORKSPACE 文件是否存在 | yaml + md 存在 |
| 8 | 子 Skill 注册 | 三大子智能体 SKILL.md 是否在 .trae/skills/ 下 | 全部注册 |
| 9 | 参考文档 | REFERENCE 下 5 个文档是否完整 | 全部存在 |
| 10 | 核心脚本 | SCRIPTS 下 6 个脚本是否完整 | 全部存在 |
路由逻辑（伪代码）
function route_user_request(user_input):
has_source_code = detect_if_user_has_code(user_input)
needs_id_cleanup = detect_base64_or_id(user_input)
needs_teaching = detect_teaching_need(user_input)
needs_asset = detect_asset_need(user_input)
if "从零" in user_input or "没有代码" in user_input:
# 场景 B：无源码
invoke("rpa-module-asset-agent") # 先资产生成
invoke("rpa-teacher-agent") # 再老师教学
invoke("rpa-crack-agent") # 最后注入 ID
elif has_source_code and needs_id_cleanup:
# 场景 A：有源码需清 ID
invoke("rpa-crack-agent") # 先清旧 ID
invoke("rpa-module-asset-agent") # 再补素材
invoke("rpa-teacher-agent") # 最后讲框选
elif needs_teaching_only:
invoke("rpa-teacher-agent")
elif needs_id_cleanup_only:
invoke("rpa-crack-agent")
elif needs_asset_only:
invoke("rpa-module-asset-agent")
else:
# 兜底：完整流程
invoke("rpa-crack-agent")
invoke("rpa-module-asset-agent")
invoke("rpa-teacher-agent")
相关文档快链
| 文档 | 路径 |
|---|
| 系统完整说明 | f:\RPA(1)\rpa-student-multi-agent-system\SYSTEM_README.md |
| 老师教学 Skill | f:\RPA(1)\rpa-student-multi-agent-system\AGENTS\agent_teacher\SKILL_TEACH.md |
| 破障修复 Skill | f:\RPA(1)\rpa-student-multi-agent-system\AGENTS\agent_fix_crack\SKILL_FIX.md |
| 资产模块 Skill | f:\RPA(1)\rpa-student-multi-agent-system\AGENTS\agent_module_asset\SKILL_ASSET.md |
| 用户工作区 | f:\RPA(1)\rpa-student-multi-agent-system\USER_WORKSPACE\ |
| 参考文档库 | f:\RPA(1)\rpa-student-multi-agent-system\REFERENCE\ |
