跳到正文
cccskills
免费在 GitHub 公开

yao-daemon

Start and manage long-running background services such as development servers. Check their status and output logs, verify listening ports, retrieve local URLs, and restart services while keeping the same service ID.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Daemon process management — start, monitor, restart, stop long-running services. ALWAYS invoke this skill when the user asks to start, check, restart, or stop background services, dev servers, or daemon processes.

查看安装方法

适用场景

  • Starting a development server in the background
  • Checking service status and output logs
  • Restarting a service while keeping its ID
  • Checking local connection URLs and stopping services

包含的文件(1)

  • SKILL.md4.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Daemon Management

Tools

  • yao_daemon_start — Start a long-running service. Always runs in background; returns daemon_id immediately.
  • yao_daemon_list — List daemons. Supports --status filter and --limit/--offset pagination.
  • yao_daemon_status — Get full details for a daemon (daemon_port, daemon_url, started_at, daemon_restarts).
  • yao_daemon_stop — Stop a running daemon.
  • yao_daemon_restart — Restart a daemon (preserves the same ID, increments daemon_restarts).
  • yao_job_output — Read daemon output (pass daemon_id as job_id).

Parameters

yao_daemon_start

ParamRequiredDefaultDescription
commandyes—Shell command to execute
descriptionyes—Concise 5–10 word summary
portnoauto-detectExpected listen port; the system verifies the port is ready before reporting it
argsno—Additional arguments
working_dirnoworkspaceWorking directory

yao_daemon_list

ParamDefaultDescription
statusallFilter: running, stopping, completed, failed, cancelled, port_detecting, all
limit20Max items per page
offset0Skip first N items

yao_daemon_restart / yao_daemon_status / yao_daemon_stop

ParamRequiredDescription
daemon_idyesThe daemon ID

Response Fields

All responses are JSON. Daemon objects contain:

id, kind, session_id, status, description,
command, command_argv, command_line, pid, pgid, user,
started_at, finished_at, duration_ms, exit_code, signal, detail,
daemon_port, daemon_url, daemon_restarts, seq
  • daemon_port — The verified listen port (0 if not yet detected or not specified).
  • daemon_url — http://localhost:<port> (empty until port is verified as listening by the daemon's own process tree).
  • daemon_restarts — Number of restarts via yao_daemon_restart.
  • started_at — Unix millisecond timestamp of the most recent start.

Port detection behavior:

Both modes start by returning port_detecting with daemon_port: 0 if the port is not confirmed within the initial ~2s settle window. If the port is confirmed within ~2s, start returns running with daemon_port/daemon_url directly.

  • --port N (explicit): Verifies port N is listening AND owned by this daemon's process tree. If not confirmed within ~2s, returns status: "port_detecting". Poll yao_daemon_status until status changes to running — either with daemon_port: N and daemon_url (port confirmed), or with daemon_port: 0 and detail: "specified port N not detected within timeout" (~60s).
  • No --port (auto-detect): Scans the daemon's process tree for any listening TCP port. If not found within ~2s, returns status: "port_detecting". The scan continues in background (~60s); if a port is found, status changes to running with daemon_port/daemon_url and a <BackgroundJobReceipt> is delivered. If no port is found after ~60s, status changes to running with daemon_port: 0.

List (paginated)

{ "daemons": [...], "total": 5, "offset": 0, "limit": 20, "has_more": false }

Stop (already terminal)

{ "job": { ... }, "detail": "already in terminal state (cancelled); no action taken" }

Errors

Structured JSON with code and message:

{ "error": { "code": "not_found", "message": "daemon \"dmn_xxx\" not found" } }

Codes: invalid_argument, not_found, internal.

Usage Rules

  1. Always provide a description.
  2. Specify port when starting a server — the system confirms the port is actually listening before reporting daemon_url.
  3. Daemons run indefinitely — use yao_daemon_stop to terminate.
  4. Use yao_daemon_restart to restart a crashed or misconfigured daemon without losing its ID.
  5. Monitor output with yao_job_output passing the daemon_id as job_id.

BackgroundJobReceipt

When a daemon's port becomes ready, the system delivers a <BackgroundJobReceipt> XML message containing the daemon_url. Use that URL for subsequent HTTP requests to the daemon.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

yao-agent

免费

Manage agents on a host by listing their capabilities, reading source code, and downloading or deploying agents in the smith namespace. Check available language model connections and their roles without exposing API keys.

中文简介正在准备中。当前显示英语简介。

  • Find available agents and check their capabilities
  • Study existing agent source code
  • Download and deploy smith agents for editing
YaoApp/yao81472026年10月18日 更新

yao-audio

免费

Turn recorded speech into text from supported audio files such as mp3, m4a, and wav. Detect the language automatically or specify it, and list available speech recognition providers and models before choosing one.

中文简介正在准备中。当前显示英语简介。

  • Transcribe a meeting recording
  • Convert an audio recording into text
  • Transcribe audio in a specified language
YaoApp/yao81472026年10月18日 更新

yao-board

免费

Check kanban boards, which organize tasks into columns, and retrieve task lists filtered by status, assistant, or board. Use the returned data to see task counts and review work in progress.

中文简介正在准备中。当前显示英语简介。

  • Reviewing board columns and task counts
  • Finding tasks that are running or waiting
  • Checking tasks assigned to a specific assistant
YaoApp/yao81472026年10月18日 更新

Classify messages, rate content, or estimate probabilities using defined question types. Receive machine-readable answers, with confidence scores for classification and ratings, and apply the same questions to multiple inputs in a batch.

中文简介正在准备中。当前显示英语简介。

  • Routing customer inquiries to departments
  • Rating support quality against defined criteria
  • Classifying sentiment across multiple messages
YaoApp/yao81472026年10月18日 更新

yao-doc

免费

Look up callable processes in Yao, inspect their arguments and return types, and check whether a process name is valid. Use the documentation to prepare calls and find suggested alternatives for misspelled names.

中文简介正在准备中。当前显示英语简介。

  • Find Yao processes by keyword
  • Check arguments and return types before calling a process
  • Validate process names when a call fails
YaoApp/yao81472026年10月18日 更新

yao-image

免费

Describe photos, screenshots, and charts in text, generate images from written prompts, or edit existing images. Supports background replacement, transparent output, and edits limited to an area defined by a mask.

中文简介正在准备中。当前显示英语简介。

  • Get a text description of a photo or screenshot
  • Generate a landscape image from a written prompt
  • Replace a photo background or change its style
YaoApp/yao81472026年10月18日 更新

查看 YaoApp 的全部技能

报告此技能的问题