Hephaestus
让开发代理按发现动态生成并协调软件工作流。
这个 Agent 能做什么，适合哪些场景？
Hephaestus 是一个面向软件开发的半结构化代理框架，工作流由代理在执行中根据新发现扩展，而非预先写死全部分支。它以分析、实现和验证等 Phase 定义工作类型，并让代理动态创建带阻塞关系的 Kanban tickets。README 描述 Guardian 用于监控代理是否与阶段目标保持一致，并提供实时可观测性界面来查看隔离会话中的代理活动。代理可在 tmux 隔离环境中调用 Claude Code、OpenCode、Droid 或 Codex 等 CLI 工具；Qdrant 用作向量存储，另有 Node.js 前端。Hephaestus Dev 提供从 PRD 构建软件、修复缺陷、索引仓库、功能开发和生成文档五种预配置工作流。
用户先定义 Phase 及其完成条件，再由分析代理阅读任务或 PRD 并创建后续 tickets。实现和验证代理可以继续处理当前票据，同时根据测试失败、优化机会或其他发现，向任意 Phase 新增调查、修复、实现或复测 tickets，并通过 blocking relationships 协调依赖。Guardian 监控工作是否符合阶段指令；Kanban board、依赖图和可观测性视图展示形成中的工作流。Hephaestus 在 tmux 中运行所选的 Claude Code、OpenCode、Droid 或 Codex CLI，并要求配置 Hephaestus 与 Qdrant MCP servers。Hephaestus Dev 的入口命令为 python run_hephaestus_dev.py --path /path/to/project。
- 软件团队拿到 PRD 后，希望把认证、REST API、前端、数据库和后台任务拆成可并行推进的工作时。
- 维护者在现有 Git 仓库中修复缺陷，并希望将分析、修复和验证作为可追踪 tickets 协调时。
- 接手陌生代码库的开发者需要先扫描并建立内存中的代码库知识，再开始功能开发时。
- 测试人员在验证阶段发现性能机会或安全问题，并希望自动创建调查、实现和复测工作时。
- 需要为已有代码库生成较完整文档，并希望使用预配置开发工作流的团队。
这个 Agent 有哪些优点和局限？
- 以 Phase 类型约束工作类别，同时允许代理根据发现动态创建任务，不需要预先定义每一条分支。
- Kanban tickets 和 blocking relationships 为并行开发、修复与验证提供了显式协调机制。
- Guardian 监控阶段对齐，配合实时可观测性和 tmux 隔离会话，便于观察多代理执行。
- Hephaestus Dev 已列出五种软件开发工作流，覆盖从 PRD 构建、仓库索引到缺陷修复。
- 运行环境较重：需要 Python、tmux、Git、Docker、Qdrant、Node.js、npm 和至少一种代理 CLI。
- 需要配置多项 API credentials 与 Hephaestus/Qdrant MCP servers；README 未给出完整安装命令或配置格式。
- 项目状态标为 Alpha，采用前应为运行稳定性和流程变更预留验证成本。
- 仓库元数据标注 License 为 NOASSERTION，而 README 声称 AGPL-3.0；许可状态需要在采用前单独核实。
如何安装或部署这个 Agent？
README 未提供克隆仓库、安装 Python/前端依赖或 .env 文件格式的命令，因此无法据此给出完整安装流程。已明确的前置条件是：Python 3.10+、tmux、Git、Docker、Node.js、npm，以及 Claude Code、OpenCode、Droid 或 Codex 之一；目标项目必须是 Git 仓库。还需要 API keys：OpenAI、OpenRouter、Anthropic，或 README 所列的 Azure OpenAI、Google AI Studio 支持路径之一；并需为 Hephaestus 和 Qdrant 配置 MCP servers。macOS 可运行 python check_setup_macos.py 检查 CLI、.env API keys、MCP、Docker/Qdrant 和依赖状态。
如何使用这个 Agent？
在满足前置条件并完成 MCP、LLM 配置后，对目标 Git 项目运行：python run_hephaestus_dev.py --path /path/to/project。该入口启动 Hephaestus Dev 的预配置开发工作流；README 未说明如何通过命令行选择五种具体工作流或传入 PRD，因此这些参数不能从现有证据中补充。
这个 Agent 与同类方案有什么区别？
README 将其定位为介于传统预定义分支工作流与无结构代理之间：传统框架要求预先为分支编写指令，而 Hephaestus 允许代理在 Phase 结构内动态创建任务。