73 lines
2.2 KiB
Markdown
73 lines
2.2 KiB
Markdown
# TaskPool Agent Skill
|
||
|
||
你正在通过 **TaskPool MCP Server** 操作「任务池」自动化调度面板。
|
||
真正执行依赖 MCP Tools；本 Skill 只规定操作流程与安全边界。
|
||
|
||
## 何时使用
|
||
|
||
用户提到：任务、定时任务、脚本、环境变量、执行日志、重跑失败任务、巡检 TaskPool/任务池 时，优先使用 `taskpool` MCP。
|
||
|
||
## 连接检查
|
||
|
||
1. 先调用 `ping_api`
|
||
2. 失败则提示检查：
|
||
- 面板是否启用 OpenAPI
|
||
- `TASKPOOL_URL` / `TASKPOOL_TOKEN` 是否正确
|
||
- 后端是否在运行
|
||
|
||
## 标准流程
|
||
|
||
### 巡检
|
||
|
||
1. `list_tasks`（可加 `enabled=true`）
|
||
2. `list_logs` 查看最近失败（如有 status 参数则筛选 failed）
|
||
3. 对关键失败调用 `get_log` 总结原因
|
||
4. 仅在用户同意后 `run_task` 重跑
|
||
|
||
### 执行已有任务
|
||
|
||
1. `list_tasks` 或用户给出的 id → `get_task` 确认
|
||
2. `run_task`（id 必填）
|
||
3. `list_logs(task_id=...)` 取最新
|
||
4. `get_log` 汇报状态与关键输出
|
||
|
||
### 创建定时任务
|
||
|
||
1. 向用户确认：名称、命令、cron、工作目录、超时
|
||
2. `create_task`（name 必填；普通任务 command 必填）
|
||
3. `get_task` 回读确认
|
||
|
||
### 改任务
|
||
|
||
1. `get_task`
|
||
2. `update_task` 只传要改的字段
|
||
3. 回读确认
|
||
|
||
### 脚本 / 环境变量
|
||
|
||
- 脚本：`list_scripts` → `get_script` → 必要时 create/update
|
||
- 环境变量：`list_envs` / `get_env`；secret 值通常脱敏，不要臆造明文
|
||
|
||
## 安全规则
|
||
|
||
1. **删除**（`delete_task` / `delete_script` / `delete_env`）前必须明确征得用户同意
|
||
2. 不要编造任务/日志 ID
|
||
3. 不要把 Token、secret 环境变量原文写入回复
|
||
4. 不要用 MCP 执行「任意系统破坏性命令」；只操作面板内已建模的任务
|
||
|
||
## 能力边界
|
||
|
||
| 可做 | 不可做（当前） |
|
||
|------|----------------|
|
||
| 任务 CRUD、执行、停跑 | 在线终端交互 |
|
||
| 脚本 CRUD | Mise 语言安装 UI 全流程 |
|
||
| 环境变量 CRUD | 消息渠道复杂配置向导 |
|
||
| 日志查询 | 直接操作数据库 |
|
||
|
||
## 话术示例
|
||
|
||
- 「帮我看看任务池里有哪些启用任务」
|
||
- 「把备份任务跑一遍并告诉我结果」
|
||
- 「最近失败的任务是什么原因，要不要重跑？」
|
||
- 「建一个每天 3 点执行的清理任务」
|