SuperAPI AI 工具集

herobrine

智能体与模型

查看项目

更新于 10-15 08:08

技能介绍

Herobrine 是一个让 Claude Code 以守护进程方式运行的技能,用于创建、列出、删除和运行定时自主 Claude Code 智能体。它把 Claude Code 从交互式工具变成可按计划自动执行任务的自动化系统。

用途

Herobrine 用于设置定时自主运行的 Claude Code 智能体。每个智能体由名称、提示词和调度计划定义,到点后自动执行任意提示词,适合晨间简报、夜间构建、定期研究等重复性任务。

主要能力

  • 创建、列出、删除、立即运行智能体,以及查看历史运行日志。
  • 通过 macOS launchd 定时触发,每个智能体拥有独立的 launchd plist,保证调度可靠。
  • 以无头模式执行 claude -p,并使用 --dangerously-skip-permissions 完全自主运行,无需人工确认。
  • 结果发送到 Beeper 聊天(可选),同时保存到本地日志,并通过 macOS 通知确认完成。
  • 智能体可调用其他技能(如 /steve、/rnv、/gsd:execute-plan),因为它是一个完整的 Claude Code 实例。
  • 支持选择模型(opus、sonnet 默认、haiku)和最大轮次(默认 50)。

使用方式

安装脚本

将运行器和管理脚本复制到 ~/.claude/agents/:

mkdir -p ~/.claude/agents/schedules ~/.claude/agents/logs
cp scripts/run-agent.sh ~/.claude/agents/run-agent.sh
cp scripts/manage-agent.sh ~/.claude/agents/manage-agent.sh
chmod +x ~/.claude/agents/run-agent.sh ~/.claude/agents/manage-agent.sh

配置 Beeper 投递(可选)

找到 Beeper 的“Note to Self”聊天 ID,更新 manage-agent.sh 中的默认 DELIVERY_CHAT。每次运行后,智能体会将完整结果作为格式化的 Beeper 消息发送。如果不使用 Beeper,结果仍会保存到 ~/.claude/agents/logs/ 并通过 macOS 通知投递。

操作

根据 $ARGUMENTS 中的动作关键字(create、list、remove、run-now、logs)执行对应操作,否则通过 AskUserQuestion 询问用户。

创建智能体时需收集:名称(小写带连字符)、提示词(可包含技能调用)、调度计划(如每天早 8 点 0 8 * * *、每天晚 6 点 0 18 * * *、每小时 every-1h、每 30 分钟 every-30m、工作日早 9 点 0 9 * * 1-5,或自定义 cron/间隔)、模型、最大轮次。然后运行:

bash ~/.claude/agents/manage-agent.sh create "<name>" "<prompt>" "<schedule>" "$HOME" "<model>" <max_turns>

列出:

bash ~/.claude/agents/manage-agent.sh list

删除(若未给名称,先列出再询问):

bash ~/.claude/agents/manage-agent.sh remove "<name>"

立即运行:

bash ~/.claude/agents/manage-agent.sh run-now "<name>"

查看日志:

bash ~/.claude/agents/manage-agent.sh logs [agent-name]

适用场景

资料给出的示例包括:stock-news(工作日早 8 点研究股市动态与科技财报)、pr-digest(工作日早 9 点审查仓库开放 PR)、overnight-build(每天凌晨 2 点用 /steve 实现项目下一阶段)、security-scan(每周一凌晨 6 点审计 OWASP Top 10 漏洞)、dep-updater(每周日凌晨 3 点检查过时依赖并创建 PR)。

文件结构

~/.claude/agents/
├── run-agent.sh              # Executes claude -p, delivers results
├── manage-agent.sh           # Create/list/remove/run-now/logs
├── schedules/                # Agent configs (JSON)
│   └── stock-news.json
└── logs/                     # Execution logs
    ├── stock-news_20260211_080000.log
    └── stock-news_launchd.log

~/Library/LaunchAgents/
└── com.claude.agent.stock-news.plist   # macOS scheduler

限制

  • 依赖 macOS launchd,仅适用于 macOS。
  • 智能体以 --dangerously-skip-permissions 完全自主运行,无任何提示确认。
  • Beeper 投递为可选配置,需手动设置聊天 ID。
  • 资料未提供其他平台支持、收费或价格信息。