yao 技能优化

运维部署社区

作者仓库星标 7,542
作者仓库 yao

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

原文结构

agentlist：List available agents. Returns ID, name, description, and capabilities for each agent. Parameter · Type · Required · Description namespace · string · no · Filter by namespace (e.g. yao, smith). Omit for all.
agentdownload：Download a smith-namespace agent into the development directory for editing. Restricted to smith namespace only — for other agents, use agentreference. Parameter · Type · Required · Description id · string · yes · Agent ID in dot notation. Must be smith..
agentreference：Download agent source code from the host into .references/ for read-only study. Any agent across all namespaces can be referenced. Parameter · Type · Required · Description id · string · yes · Agent ID in dot notation (e.g. yao.slides)

适用与边界

当前原文没有单列适用场景。
当前原文没有单列不适用场景或限制。

原文中的明确线索

要点：「smith-namespace」、「Restricted to smith namespace only」、「read-only study」、「Restricted to the smith namespace only」、「without API keys」
文件与命令：namespace、yao、smith、agentreference、smith.、agent-smith-dev/assistants/smith/<name>/、.references/、yao.slides

流狐整理：以上内容来自当前 SKILL.md 的章节与原词；未补写作者没有声明的工具、兼容性或能力。

Agent Tools

Five tools for managing agents on the host, called via bash.

agent_list

List available agents. Returns ID, name, description, and capabilities for each agent.

tai tool agent_list '{}'
tai tool agent_list '{"namespace": "smith"}'

Parameter	Type	Required	Description
`namespace`	string	no	Filter by namespace (e.g. `yao`, `smith`). Omit for all.

agent_download

Download a smith-namespace agent into the development directory for editing. Restricted to smith namespace only — for other agents, use agent_reference.

tai tool agent_download '{"id": "smith.weather"}'

Parameter	Type	Required	Description
`id`	string	yes	Agent ID in dot notation. Must be `smith.*`.

Downloaded code lands in agent-smith-dev/assistants/smith/<name>/.

agent_reference

Download agent source code from the host into .references/ for read-only study. Any agent across all namespaces can be referenced.

tai tool agent_reference '{"id": "yao.slides"}'
tai tool agent_reference '{"id": "yao.keeper"}'

Parameter	Type	Required	Description
`id`	string	yes	Agent ID in dot notation (e.g. `yao.slides`)

Referenced code lands in agent-smith-dev/.references/<namespace>/<name>/.

agent_deploy

Deploy agent source code from the sandbox development directory to the host. Restricted to the smith namespace only — attempts to deploy to other namespaces will be rejected.

tai tool agent_deploy '{"id": "smith.weather"}'
tai tool agent_deploy '{"id": "smith.weather", "message": "add SUI page"}'

Parameter	Type	Required	Description
`id`	string	yes	Agent ID in dot notation. Must use `smith` namespace.
`message`	string	no	Optional deploy message for logging.

agent_connectors

Get the current user's LLM connector matrix. Returns metadata for each role (default, heavy, light, vision, etc.) without API keys. Use this to understand which models are available and their capabilities.

tai tool agent_connectors '{}'

No parameters required.

Guidelines

Use agent_list to discover agents before downloading or referencing
agent_download is for editing smith agents — code lands in agent-smith-dev/assistants/smith/<name>/
agent_reference is for studying any agent — code lands in agent-smith-dev/.references/<namespace>/<name>/
Deploy is restricted to the smith namespace for safety
Connector data never includes API keys, secrets, or tokens
All output is JSON

流狐档案作者与许可取自来源；运行、权限和网络为流狐检测或估算

流狐分类: 运维部署
作者声明 Agent: 未找到明确声明；不据此推断已兼容或已测试
静态检查: 88 / 100 · 启发式扫描，不代表运行安全
作者 / 版本 / 许可: @YaoApp · 未声明 license
流狐 Token 估算: 低消耗
流狐接入估算: 即装即用
是否需要外部 API Key: 未发现要求
检测到的系统要求: 未声明
底层运行要求: 未声明
检测到的文件与系统行为: 只读
检测到的网络行为: 仅限本地
安装命令数: 无（仅作为资料）

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 yao-agent.preview

作者没有在当前 SKILL.md 中定义固定输出样例。

SKILL.md SKILL.md

# Agent Tools

Five tools for managing agents on the host, called via bash.

## agent_list

List available agents. Returns ID, name, description, and capabilities for each agent.

```bash
tai tool agent_list '{}'
tai tool agent_list '{"namespace": "smith"}'
```

| Parameter   | Type   | Required | Description                                              |
|-------------|--------|----------|----------------------------------------------------------|
| `namespace` | string | no       | Filter by namespace (e.g. `yao`, `smith`). Omit for all. |

## agent_download

Download a **smith-namespace** agent into the development directory for editing. **Restricted to `smith` namespace only** — for other agents, use `agent_reference`.

```bash
tai tool agent_download '{"id": "smith.weather"}'
```

| Parameter | Type   | Required | Description                                              |
|-----------|--------|----------|----------------------------------------------------------|
| `id`      | string | yes      | Agent ID in dot notation. Must be `smith.*`.             |

Downloaded code lands in `agent-smith-dev/assistants/smith/<name>/`.

## agent_reference

Download agent source code from the host into `.references/` for **read-only study**. Any agent across all namespaces can be referenced.

```bash
tai tool agent_reference '{"id": "yao.slides"}'
tai tool agent_reference '{"id": "yao.keeper"}'
```

| Parameter | Type   | Required | Description                                        |
|-----------|--------|----------|----------------------------------------------------|
| `id`      | string | yes      | Agent ID in dot notation (e.g. `yao.slides`)       |

Referenced code lands in `agent-smith-dev/.references/<namespace>/<name>/`.

## agent_deploy

…

证据边界与执行链路

作者原文负责流程事实；流狐只索引当前章节、要点、文件与命令。

章节    -> agentlist → agentdownload → agentreference → agentdeploy → agentconnectors → Guidelines
要点    -> smith-namespace · Restricted to smith namespace only · read-only study · Restricted to the smith namespace only · without API keys
文件/命令 -> namespace · yao · smith · agentreference · smith. · agent-smith-dev/assistants/smith/<name>/ · .references/ · yao.slides
内容 SHA-256 -> 71c7c5f6a6b5