用途:Garden 是一个单次运行的自主维护智能体。调用后它会扫描项目、找出一个值得修复的维护问题、修好并提交 PR,然后停止,类似每次只拔一根杂草的园丁。其理念源自 agent-first engineering 中的 doc-gardening 与 garbage collection:小批量持续维护优于痛苦的集中清理。
主要能力与流程:
- Setup:创建 garden/ 前缀分支的 worktree,命令为 git worktree add "$WORKTREE" -b garden/<descriptive-slug>。需记录仓库与 worktree 路径,后续命令显式传入 worktree 路径,不要用 garden-* glob 重新推导路径。
- Scan:广泛扫描维护问题。当前活跃的是文档(Docs plot),包括过期文档、失效引用、缺失文档、文档间或与代码不一致、README 漂移。不要修改日志类或追加型文档,如 docs/decisions.md、docs/diary/、CHANGELOG/HISTORY;不确定是活文档还是历史记录时保持不动。未来计划扩展代码、依赖、测试、配置等 plot,目前不执行。
- Select:从发现中挑选单个最值得修复的问题,说明选择理由。
- Fix:做最小且聚焦的修改,一次一个问题一个 PR,遵循项目既有约定(如 CLAUDE.md、linter、代码风格),提交清晰信息。
- Self-review:派发两个竞争性子智能体(model: "opus")审查修改,检查正确性、是否引入新问题、是否真正解决所发现的问题。
- Iterate:若审查发现问题则修复、提交并重新审查,最多 3 轮;仍有未解决问题则在 PR 描述中说明。
- Ship:向主分支开 PR,描述包含 What was found、What was fixed、Review notes 三部分;随后删除 worktree 并停止,命令为 git worktree remove <the-worktree-path-from-step-1>。
适用场景:适合需要持续、小批量维护文档与项目卫生的代码仓库。限制:当前仅文档 plot 活跃;不修改历史记录类文档;单次只处理一个问题;未提供收费、价格、平台支持等信息。