eliasstravik/herdr-projects
# Herdr Projects 学习卡
一、一句话定位
Herdr Projects 是 Herdr 的插件，让你用一个“协调者”对话同时管理多个编码 agent 并行干活，每个任务独立分支，无需手动逐个派活和跟踪状态。
二、核心技术/架构亮点
1. 协调者只调度不干活：始终有空回答你，任务由独立线程执行。
2. 每个任务独立 git worktree + branch（无仓库时用独立文件夹），互不干扰。
3. 统一指令与记忆：每个线程自动获得相同 standing instructions 和项目记忆，线程报告的 `Remember` 会回流沉淀。
4. 状态分组视图：线程按 `ready-for-review / waiting-on-you / working / landing / idle` 分组，侧边栏和文本弹窗均可查看。
5. 安全设计：不自动 merge/push/删除分支；权限按子命令 allow-list；配置为本地 Markdown/TOML，支持自有 SSH 机器。
三、适用场景与目标用户
- 单个 agent 不够、手动管理多个 agent 太累的中大型编码任务。
- 希望并行开发但保持统一上下文、且数据留在本机的团队或个人。
- 已在 macOS/Linux 使用 Herdr + Claude Code 等 agent CLI 的开发者。
四、可动手动作
1. 安装：`herdr plugin install eliasstravik/herdr-projects`（需 Cargo 构建）。
2. 建项目：`herdr-projects new "Billing" --repo ~/dev/app`，再 `herdr-projects open billing`。
3. 在协调者窗口描述需求，批准它建议的线程，观察侧边栏状态。
4. 自检：`herdr plugin action invoke doctor --plugin herdr-projects`。
5. 借鉴思路：可模仿“协调者+多 agent+状态分组”的并行协作模式。
五、学习优先级
- P0（本周动手）：安装并跑通一个最小项目——核心价值就是并行协调，亲手体验最快。
- P1（排期）：研读权限 allow-list 与 `thread adopt` 机制——这是安全落地和复用已有会话的关键。
- P2（观念了解）：理解 memory 回流与 TASKS.md 的项目自组织方式——可迁移到其他 agent 编排设计。
- P3（略读）：其余运维细节（ticker、SSH 远程线程等），按需再看。⌂