docs: add MCP agent skill document
Build and Deploy / build-and-push (push) Successful in 1m15s

This commit is contained in:
2026-07-26 19:30:57 +08:00
parent a0a90f558c
commit 29319ee2d3
+72
View File
@@ -0,0 +1,72 @@
# 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 点执行的清理任务」