Herduck Skill 技能

Herduck — 面向 Coding Agent 的持久工作层

Herduck 是一款专为 AI 编程 Agent（Claude Code、Codex、OpenCode、Pi、Gemini CLI、Cursor 等）打造的开源"工作上下文基础设施"。它把分散在多个 Agent 会话、不同终端窗口、不同项目目录中的目标、进展、阻碍与下一步重新组装成一张可继续推进的 Work，让"明天打开电脑，Agent 还能接得上昨天的活"成为可能。

核心能力

Work 视角：每项工作都有 Goal、Status、Blocker、Next Steps 四项最小组件，叠加阅读历史会话、Git 记录和终端证据，跨 Agent 跨会话保持工作稳定。

Agents 视角：在终端里同时运行多个 Coding Agent，实时显示"工作 / 等待 / 空闲 / 未启动"四种状态，一目了然。

Projects 视角：按目录组织 Agent 和会话，复用你熟悉的文件夹结构，从工作区切换就能接上原有上下文。

Sessions 视角：本地保存所有 Agent 会话历史，支持搜索、预览和"用原 Agent 继续对话"的能力。

Work 对象全局视野：以 Work 为单位管理"目标—进展—阻碍—下一步"，即使 Agent 更换、模型更换、会话重启，Work 仍保持完整。

兼容 6 款主流 Agent：Claude Code、Codex、OpenCode、Pi、Gemini CLI、Cursor 均原生支持，快捷键设计与 Herdr 对齐。

真实 Ghostty 终端：基于 Ghostty 渲染引擎的本地原生界面，比 Web 端抽屉更可控。

安装与配置

源码安装：git clone https://github.com/wenhanweime/herduck.git && cd herduck && just install herduck，需要 Rust 1.96.1、Zig 0.15.2、just 等工具链，macOS 编译后需手动重签名。

npm 预览：npx --yes herduck@alpha，需要 Node.js 20+，提供终端与会话库；Work 计划与进展概览请使用源码版。

Agent CLI 单独安装：支持 macOS / Linux，登录账号后即可被 Herduck 识别并接入。

使用步骤

1. 下载源码或通过 npm 安装 Herduck，启动应用并按文档准备工具链（首次需 rustup / brew install 命令）。
2. 安装至少一款支持的 Coding Agent（Claude Code、Codex、Cursor 等），登录账号。
3. 在 Herduck 中创建 Work，填写目标、现状、阻碍和下一步。
4. 让 Agent 跑起来，Herduck 自动归类对话到对应 Work；闲置一段时间后 Agent 自动进入睡眠模式，释放内存。
5. 下次回来时，从 Work 列表选择对应项，点击"继续"即可让原 Agent 接着推进。

适用场景

多 Agent 并行任务：用 Claude Code 做调研、Codex 做实现、Cursor 做 UI 打磨，多个不同 Agent 同时跑不丢活。

跨天跨周项目：GitHub Issue、Cursor 内的项目、Claude Code 会话三处同存，Herduck 聚合后给到统一视角。

远程协作：把 Work 视图同步给团队成员，对方一眼看到当前进展与待解决问题。

资源受限设备：闲置自动睡眠、释放内存，长时间挂着不会吃满 CPU / 内存。

适用人群

使用 Claude Code / Codex / Cursor 的独立开发者、需要并行跑多个 Coding Agent 的资深程序员、跨项目跨设备工作的远程协作团队，以及经常"打开同一个项目就完成昨天那步"的研究型技术工作者。

工作原理

Herduck 把"工作"视为跨会话的执行环境，持久化 Goal / Status / Blocker / Next Steps 这四项最小组件，其它进展、决策、尝试、上下文都从会话、文件、Git、终端等"证据"动态重建。它不做传统项目管理工具的庞大上下文，而是以最小持久 + 证据重建的方式让工作保持连贯。

官方链接

官网：https://www.herduck.com GitHub：https://github.com/wenhanweime/herduck