hermes-cli-from-other-agents

Files (1)

• SKILL.md

SKILL.md (first lines)

---
name: hermes-cli-from-other-agents
description: 当其他 agent（如 OpenCode, Cursor, Claude Code）需要调用 Hermes CLI 来管理系统配置、Kanban 看板或定时任务时的参考指南。涵盖 profiles 职能、调用模式和常见陷阱。
version: 1.0.0
platforms: [windows]
environments: [agent-collaboration]
metadata:
  hermes:
    tags: [hermes-cli, profile, kanban, cron, multi-agent]
    related_skills: [dotfiles, kanban-worker, kanban-orchestrator, dotfiles-install-targets]
---
# Hermes CLI from Other Agents

## 概述

本机安装有多个 **Hermes Agent profiles**。其他 AI agent（OpenCode、Cursor、Claude Code 等）可以通过 `hermes -p <profile> -z "指令"` 将特定任务委托给对应的 Hermes profile。

所有 Hermes 配置存储在 `%LOCALAPPDATA%\hermes\` 下（即 `C:\Users\wps\AppData\Local\hermes\`）。

---

## Profiles 与职责

| Profile | 模型 | 角色 | 职责 |
|---|---|---|---|
| `default` | deepseek-v4-flash | 通用助手 | 默认 profile, 通用任务 |
| `system_manager` | deepseek-v4-flash | **系统管理员** | 管理 dotfiles-windows 仓库、软件安装、系统服务、配置文件、系统优化 |
| `orchestrator` | deepseek/deepseek-v4-pro (wps_claude) | **工作流管理器** | Kanban orchestration：任务分解、路由、多 agent 协作 |

### system_manager — 系统管理员

适合处理以下任务：
- 安装/卸载软件（choco, scoop, pip, npm, cargo 等）
- 修改系统服务（sshd, keymap 等）
- 修改 dotfiles-windows 仓库中的配置文件
- 运行 `install.py` 应用配置
- 系统优化与调试

**调用方式：**
```bash
hermes -p system_manager -z "请帮我安装 ripgrep"
hermes -p system_manager -z "修改 ~/.gitconfig，添加 proxy 配置"
hermes -p system_manager -z "运行 install.py all"
```

### orchestrator — 工作流管理器

适合处理以下任务：
- 将大型任务分解为多个 Kanban 子任务
- 创建和管理 Kanban 看板
- 多 profile 协作工作流编排
- 创建定时器/定时任务
- 技能管理（skills）

**调用方式：**
```bash
hermes -p orchestrator -z "将'重构用户模块'拆分为 Kanban 任务"
hermes -p orchestrator -z "创建一个每天备份的 cron 任务"
```

---

## Kanban 命令（核心操作）

**重要原则：** 在 Kanban worker 会话内使用 `kanban_*` 工具函数；在非 worker 上下文中（其他 agent 调用）使用 `hermes kanban` CLI。

### 创建任务
```bash
hermes kanban create "任务标题" \
  --assignee system_manager \
  --body "详细描述"
```

### 创建带依赖的任务
```bash
hermes kanban create "子任务" \
  --assignee system_manager \
  --parent T_xxx
```

### 查看任务
```bash
hermes kanban show T_xxx          # 详细信息 + 评论 + 事件日志（默认已包含）
```

### 列示任务
```bash
hermes kanban list                        # 所有未完成任务
hermes kanban list --status ready         # 按状态筛选
hermes kanban list --assignee system_manager  # 按 profile 筛选
```

### 任务生命周期
```bash
hermes kanban claim T_xxx          # 认领任务（输出工作空间路径）
hermes kanban comment T_xxx "备注" # 添加评论
hermes kanban block T_xxx "原因"   # 阻塞
hermes kanban unblock T_xxx        # 解除阻塞
hermes kanban complete T_xxx       # 完成
hermes kanban archive T_xxx        # 归档
```

### 工作流管理
```bash
hermes kanban link T_xxx T_yyy    # 添加依赖（parent child 为位置参数）
hermes kanban promote T_xxx       # 手动推进到 ready（恢复路径）
hermes kanban reassign T_xxx system_manager --reclaim  # 转派
hermes kanban tail T_xxx          # 跟踪事件流
```

### 看板管理
```bash
hermes kanban boards              # 列出看板
hermes kanban stats                # 看板统计
# 创建 Swarm 任务组（--worker 可重复；--verifier/--synthesizer 必填 profile）
hermes kanban swarm --worker system_manager:任务1 --verifier orchestrator --synthesizer orchestrator "目标"
```

---

From wang-zi-tao/dotfiles, MIT.

More from wang-zi-tao/dotfiles