aden-hive/hive✦ 精选0°

hive.terminal-tools-job-control

仓库创建 2026年1月12日最近提交 1 个月前SkillHot 收录 20 天前
▸ 精选理由

方便监控构建、部署和日志流,避免对话阻塞与丢失输出。

▸ 风险提示

管理长期作业可能泄露日志或占用系统资源,需配额与权限控制

这个 Skill 做什么

说明如何以后台作业启动、轮询与流式监控长期或持续运行任务。

用来启动并管理长时间运行或会产生日志流的后台任务,比如构建、部署或持续测试。遵循 start→poll→wait 的操作模式,按日志偏移拉取增量输出,并支持 wait_until_exit、合并 stderr 等选项。还内建任务终止的阶梯式策略(SIGINT→SIGTERM→SIGKILL),且要注意任务会随 terminal-tools 服务重启而终止。

▸ 展开 SKILL.md 英文原文

Use when launching anything that runs longer than a minute, anything that streams logs, anything you want to keep running while doing other work — or when terminal_exec auto-backgrounded on you and returned a job_id. Teaches the start→poll→wait pattern with terminal_job_logs offset bookkeeping, the `wait_until_exit=True` blocking-poll idiom, the truncated_bytes_dropped resumption signal, the merge_stderr decision, the SIGINT→SIGTERM→SIGKILL escalation ladder via terminal_job_manage, and the hard rule that jobs die when the terminal-tools server restarts. Read before calling terminal_job_start, or right after terminal_exec auto-backgrounded.

开发编程后台作业日志流监控通用
1.1w
Stars
5.7k
Forks
18
仓库内 Skill
+132
7 日增星
安装 / 使用
给你的 Agent 一句话(通用)
帮我安装这个 skill:https://raw.githubusercontent.com/aden-hive/hive/main/core/framework/skills/_preset_skills/terminal-tools-job-control/SKILL.md
或 curl 直取 SKILL.md
curl -fsSL "https://raw.githubusercontent.com/aden-hive/hive/main/core/framework/skills/_preset_skills/terminal-tools-job-control/SKILL.md"
SKILL.MD 节选查看完整文件 ↗
# Background job control

Background jobs are how you do things that take time without blocking your conversation. Three tools cover the surface: `terminal_job_start`, `terminal_job_logs`, `terminal_job_manage`.

## When to use a job

- Builds, deploys, long tests
- Processes you want to monitor (streaming a log file, a dev server)
- Anything that auto-backgrounded from `terminal_exec` (you have a `job_id`; pivot to this skill's idioms)

For one-shot work expected to finish quickly, `terminal_exec` is simpler. The auto-promotion mechanic in `terminal_exec` is your safety net — start with `terminal_exec`, take over with this skill if needed.

## Lifecycle

```
terminal_job_start(command, ...)
via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有