ForgeDock
把 GitHub issue 交给流水线,产出经过审查的合并 PR。
- Star 数
- ★ 119
- 最近更新
- 今天
- License
- AGPL-3.0
- 主语言
- JavaScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Claude CodeClaude API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 OpenCode 的维护者,希望把 GitHub issue 自动推进到经过审查的 PR。
- 不适合
- 不使用 Claude Code 或 OpenCode 的团队
- 不希望通过 GitHub 保存流程状态和注释的团队
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
ForgeDock 是面向 Claude Code 的开发流水线,也支持 OpenCode,并通过 GitHub CLI 操作仓库。其命令包括 /work-on 和 /orchestrate:前者处理单个 issue,后者按依赖关系和冲突情况并行安排里程碑任务。流水线从 issue、提交历史和相关 PR 获取上下文,并将调查、构建、审查等阶段的结构化注释写回 GitHub。它通过工作流标签和事件日志记录状态,支持中断后恢复;可在交互式命令中使用,也提供用于无头或 CI 运行的 npx forgedock run。运行需要 Node.js、已认证的 GitHub CLI,以及 Claude Code 或 OpenCode;Claude API 后端需显式配置。
安装 ForgeDock 命令后,用户可运行 /work-on <issue> 启动单 issue 流程,或运行 /orchestrate <milestone> 分解里程碑并安排并行任务。Investigate 阶段读取 issue、git blame 和相关 issue/PR,写入 FORGE:INVESTIGATOR;Context 和 Architect 阶段补充历史经验与执行计划;Build 生成分支、提交和 FORGE:BUILDER 信息。Quality Gate 执行领域检查,Review 调用安全、数据库、并发等专业审查代理,并将结构化发现写入 PR;完成后在 issue 留下 FORGE:TRAJECTORY。无头运行时,forgedock run 可选择 CLI 执行后端,forgedock run-issue 使用带事件日志、租约和恢复能力的持久化引擎。
- 使用 Claude Code 或 OpenCode 的维护者,希望把 GitHub issue 自动推进到经过审查的 PR。
- 需要并行处理里程碑任务、同时依据文件重叠和依赖关系安排执行顺序的团队。
- 希望后续代码代理能读取过往调查和审查记录的项目维护者。
- 需要在 CI 或无头环境运行流水线,并从事件日志恢复中断任务的工程团队。
- 希望把审查发现自动转成新 issue 并纳入同一工作流的团队。
如何安装或部署这个 Agent?
需要 Claude Code 或 OpenCode、已认证的 GitHub CLI,以及 Node.js ≥ 18。快速安装会将命令安装到 ~/.claude/commands/,并生成供审核的 forge.yaml。OpenCode 可安装其原生命名空间命令。
如何使用这个 Agent?
完成安装和配置后,在目标仓库的 Claude Code 会话中启动单 issue 工作流;也可提供里程碑名称运行并行编排。若要无头执行,可使用 npx forgedock run;持久化引擎入口为 npx forgedock run-issue。运行前需确保 GitHub CLI 已认证;API 后端必须显式启用。
这个 Agent 有哪些优点和局限?
- 将调查、上下文、构建和审查结果以
FORGE注释保存在 GitHub,后续运行可据此重建上下文。 /orchestrate会根据文件重叠、目录邻近、模块扇入、低置信度回退及历史共同变更安排并行波次。- 持久化引擎使用事件日志、租约和有界重试,文档说明进程重启后可对账并恢复。
- PR 审查由安全、数据库、并发等领域代理执行,并设有复现门槛筛除缺乏代码路径证据的发现。
- 交互式安装和命令面向 Claude Code;OpenCode 有独立安装方式且文档说明存在功能对等边界。
- 依赖 GitHub CLI、网络和仓库访问权限,流程状态与注释也保存在 GitHub。
- 软件免费,但模型运行依赖用户的 Claude 账户;API 后端还需显式配置。
- 无头持久化引擎已发布,而交互路径接入同一引擎仍在进行中。
这个 Agent 与同类方案有什么区别?
README 将 ForgeDock 与手动 Claude Code 工作流进行比较,并列出 DeepWiki、AGENTS.md 和 Cursor Memories 作为对照;其区别重点是把结构化流程注释写入 GitHub,并由流水线阶段读取。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ForgeDock 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 119 | 今天 | JavaScript | Claude Code |
| Maestro-Flow | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 568 | 8 天前 | TypeScript | Codex · Claude Code · Claude API |
| Kodus | 66 · 存在缺口 | 云服务 / SaaS免费版 + 付费版 | ★ 1.5k | 今天 | TypeScript | OpenAI API · Claude API |
| PR Lens | 61 · 存在缺口 | Agent 插件 / 技能免费版 + 付费版 | ★ 2.2k | 今天 | TypeScript | Codex |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档说明安装会全局写入 ~/.claude/commands/,并注册 SessionStart hook;流水线会读写 GitHub issue、PR、标签并可自动合并,且支持并行处理,因此权限和外部影响面较大,未见足够细的授权范围或逐项确认机制,扣分。初始化默认提供审核配置的界面,API 后端需要明确配置和环境变量同意,略有确认控制;文档说明凭据文件勿提交、API 不会隐式回退,但没有充分展示密钥隔离、依赖审计或来源责任细节,相关项扣分。文档描述了自动回滚 PR 和可恢复流程,但未说明通用回滚覆盖范围。
文档称状态由 GitHub 和事件日志恢复、重试有界并可升级人工处理,也提供诊断与故障排查;这些是有用设计证据。README 与入门文档对配置、yq 依赖和安装行为的说明并非完全一致,且依赖版本和可用性保障有限,因此自洽性和依赖可用性扣分;未见执行证据,不据此推断实际可靠性。
文档覆盖 Claude Code、OpenCode、交互式及 CI/headless 场景,提供配置项、预览和后端选择;也明确 OpenCode parity 边界、成本基准仍在跟踪及交互路径引擎接入尚在进行。全局安装、Claude/GitHub CLI/yq/Node 等依赖和较多 GitHub 工作流假设限制环境适配,故未给满分。
仓库材料含清晰的入门、配置、命令、故障排查和示例;AGPL-3.0 LICENSE 文本明确,许可证项给满分。配置文档之间的覆盖面与要求存在差异,README 在提供材料中截断,命令及安装演进也显示命名/兼容状态较复杂;有更新和维护命令但未明确维护责任人或持续支持承诺,故其余项扣分。
产物目标明确:从 issue 到 PR,并提供结构化审计轨迹、review、恢复和批处理能力;对已有 GitHub 工作流有潜在价值。成本描述主要是定性比较,文档明确可复现的每 issue 成本基准仍待完成,且自动合并与全局安装使错误配置的代价可能较高,故成本收益只给部分分。
操作流程、配置字段、故障症状和修复方式都有具体说明,部分产品主张链接到 issue/PR 示例;但材料中的自报使用量、成功率和速度缺少独立佐证,多个文档的配置范围不一致,也没有始终清晰标出哪些是已观察事实、哪些是产品主张,因此可追溯性和交叉印证仅部分成立。
- 运行前应审阅 forge.yaml、GitHub CLI 授权和目标仓库;文档称流水线可写 issue/PR、创建分支并自动合并,且安装会全局放置命令和 hook。
- 配置资料对 yq、可选配置范围和后端行为的描述并不完全一致;先按实际安装路径核对依赖及配置,再启用自动化。
- 吞吐量、成本和 dogfooding 数字来自项目自身说明;材料称可复现的每 issue 成本基准仍未完成。
常见问题
使用 ForgeDock 是否需要支付软件费用?
首次运行需要什么?
forge.yaml。可以在 OpenCode 中使用吗?
npx forgedock opencode install;文档同时说明 OpenCode 存在功能对等边界。任务中断后如何处理?
needs-human。流水线能否在没有 Claude Code 登录的 CI 环境运行?
forge.yaml 配置 execution.agent_backend: api 并设置 FORGEDOCK_ALLOW_API_BACKEND=1。自动模式不会隐式切换到付费 API。