feat(agents): add Hephaestus - autonomous deep worker agent (#1287)

* refactor(keyword-detector): split constants into domain-specific modules

* feat(shared): add requiresAnyModel and isAnyFallbackModelAvailable

* feat(config): add hephaestus to agent schemas

* feat(agents): add Hephaestus autonomous deep worker

* feat(cli): update model-fallback for hephaestus support

* feat(plugin): add hephaestus to config handler with ordering

* test(delegate-task): update tests for hephaestus agent

* docs: update AGENTS.md files for hephaestus

* docs: add hephaestus to READMEs

* chore: regenerate config schema

* fix(delegate-task): bypass requiresModel check when user provides explicit config

* docs(hephaestus): add 4-part context structure for explore/librarian prompts

* docs: fix review comments from cubic (non-breaking changes)

- Move Hephaestus from Primary Agents to Subagents (uses own fallback chain)
- Fix Hephaestus fallback chain documentation (claude-opus-4-5 → gemini-3-pro)
- Add settings.local.json to claude-code-hooks config sources
- Fix delegate_task parameters in ultrawork prompt (agent→subagent_type, background→run_in_background, add load_skills)
- Update line counts in AGENTS.md (index.ts: 788, manager.ts: 1440)

* docs: fix additional documentation inconsistencies from oracle review

- Fix delegate_task parameters in Background Agents example (docs/features.md)
- Fix Hephaestus fallback chain in root AGENTS.md to match model-requirements.ts

* docs: clarify Hephaestus has no fallback (requires gpt-5.2-codex only)

Hephaestus uses requiresModel constraint - it only activates when gpt-5.2-codex
is available. The fallback chain in code is unreachable, so documentation
should not mention fallbacks.

* fix(hephaestus): remove unreachable fallback chain entries

Hephaestus has requiresModel: gpt-5.2-codex which means the agent only
activates when that specific model is available. The fallback entries
(claude-opus-4-5, gemini-3-pro) were unreachable and misleading.

---------

Co-authored-by: justsisyphus <justsisyphus@users.noreply.github.com>
This commit is contained in:
YeonGyu-Kim
2026-02-01 19:26:57 +09:00
committed by GitHub
parent 720f9d3042
commit 110b1e3d2d
45 changed files with 2617 additions and 970 deletions
+20
View File
@@ -114,6 +114,7 @@
- [这是智能体时代](#这是智能体时代)
- [🪄 魔法词:`ultrawork`](#-魔法词ultrawork)
- [给想阅读的人:认识 Sisyphus](#给想阅读的人认识-sisyphus)
- [追求自主性:认识赫菲斯托斯](#追求自主性认识赫菲斯托斯)
- [直接安装就行。](#直接安装就行)
- [安装](#安装)
- [面向人类用户](#面向人类用户)
@@ -190,6 +191,7 @@
*以下所有内容都是可配置的。按需选取。所有功能默认启用。你不需要做任何事情。开箱即用,电池已包含。*
- Sisyphus 的队友(精选智能体)
- Hephaestus:自主深度工作者,目标导向执行(GPT 5.2 Codex Medium)— *合法的工匠*
- Oracle:设计、调试 (GPT 5.2 Medium)
- Frontend UI/UX Engineer:前端开发 (Gemini 3 Pro)
- Librarian:官方文档、开源实现、代码库探索 (Claude Sonnet 4.5)
@@ -206,6 +208,24 @@
- 异步智能体
- ...
### 追求自主性:认识赫菲斯托斯
![Meet Hephaestus](.github/assets/hephaestus.png)
在希腊神话中,赫菲斯托斯是锻造、火焰、金属加工和工艺之神——他是神圣的铁匠,以无与伦比的精准和奉献为众神打造武器。
**介绍我们的自主深度工作者:赫菲斯托斯(GPT 5.2 Codex Medium)。合法的工匠代理。**
*为什么是"合法的"?当Anthropic以违反服务条款为由封锁第三方访问时,社区开始调侃"合法"使用。赫菲斯托斯拥抱这种讽刺——他是那种用正确的方式、有条不紊、彻底地构建事物的工匠,绝不走捷径。*
赫菲斯托斯的灵感来自[AmpCode的深度模式](https://ampcode.com)——在采取决定性行动之前进行彻底研究的自主问题解决。他不需要逐步指示;给他一个目标,他会自己找出方法。
**核心特性:**
- **目标导向**:给他目标,而不是配方。他自己决定步骤。
- **行动前探索**:在写一行代码之前,并行启动2-5个explore/librarian代理。
- **端到端完成**:在有验证证据证明100%完成之前不会停止。
- **模式匹配**:搜索现有代码库以匹配您项目的风格——没有AI垃圾。
- **合法的精准**:像大师铁匠一样编写代码——精准、最小化、只做需要的。
#### 直接安装就行。
你可以从 [overview page](docs/guide/overview.md) 学到很多,但以下是示例工作流程。