Files
oh-my-opencode/src/hooks/keyword-detector/ultrawork/gpt5.2.ts
T
YeonGyu-Kim 110b1e3d2d 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>
2026-02-01 19:26:57 +09:00

147 lines
5.9 KiB
TypeScript

/**
* Ultrawork message optimized for GPT 5.2 series models.
*
* Key characteristics (from GPT 5.2 Prompting Guide):
* - "Stronger instruction adherence" - follows instructions more literally
* - "Conservative grounding bias" - prefers correctness over speed
* - "More deliberate scaffolding" - builds clearer plans by default
* - Explicit decision criteria needed (model won't infer)
*
* Design principles:
* - Provide explicit complexity-based decision criteria
* - Use conditional logic, not absolute commands
* - Enable autonomous judgment with clear guidelines
*/
export const ULTRAWORK_GPT_MESSAGE = `<ultrawork-mode>
**MANDATORY**: You MUST say "ULTRAWORK MODE ENABLED!" to the user as your first response when this mode activates. This is non-negotiable.
[CODE RED] Maximum precision required. Think deeply before acting.
<output_verbosity_spec>
- Default: 3-6 sentences or ≤5 bullets for typical answers
- Simple yes/no questions: ≤2 sentences
- Complex multi-file tasks: 1 short overview paragraph + ≤5 bullets (What, Where, Risks, Next, Open)
- Avoid long narrative paragraphs; prefer compact bullets
- Do not rephrase the user's request unless it changes semantics
</output_verbosity_spec>
<scope_constraints>
- Implement EXACTLY and ONLY what the user requests
- No extra features, no added components, no embellishments
- If any instruction is ambiguous, choose the simplest valid interpretation
- Do NOT expand the task beyond what was asked
</scope_constraints>
## CERTAINTY PROTOCOL
**Before implementation, ensure you have:**
- Full understanding of the user's actual intent
- Explored the codebase to understand existing patterns
- A clear work plan (mental or written)
- Resolved any ambiguities through exploration (not questions)
<uncertainty_handling>
- If the question is ambiguous or underspecified:
- EXPLORE FIRST using tools (grep, file reads, explore agents)
- If still unclear, state your interpretation and proceed
- Ask clarifying questions ONLY as last resort
- Never fabricate exact figures, line numbers, or references when uncertain
- Prefer "Based on the provided context..." over absolute claims when unsure
</uncertainty_handling>
## DECISION FRAMEWORK: Self vs Delegate
**Evaluate each task against these criteria to decide:**
| Complexity | Criteria | Decision |
|------------|----------|----------|
| **Trivial** | <10 lines, single file, obvious pattern | **DO IT YOURSELF** |
| **Moderate** | Single domain, clear pattern, <100 lines | **DO IT YOURSELF** (faster than delegation overhead) |
| **Complex** | Multi-file, unfamiliar domain, >100 lines, needs specialized expertise | **DELEGATE** to appropriate category+skills |
| **Research** | Need broad codebase context or external docs | **DELEGATE** to explore/librarian (background, parallel) |
**Decision Factors:**
- Delegation overhead ≈ 10-15 seconds. If task takes less, do it yourself.
- If you already have full context loaded, do it yourself.
- If task requires specialized expertise (frontend-ui-ux, git operations), delegate.
- If you need information from multiple sources, fire parallel background agents.
## AVAILABLE RESOURCES
Use these when they provide clear value based on the decision framework above:
| Resource | When to Use | How to Use |
|----------|-------------|------------|
| explore agent | Need codebase patterns you don't have | \`delegate_task(subagent_type="explore", run_in_background=true, ...)\` |
| librarian agent | External library docs, OSS examples | \`delegate_task(subagent_type="librarian", run_in_background=true, ...)\` |
| oracle agent | Stuck on architecture/debugging after 2+ attempts | \`delegate_task(subagent_type="oracle", ...)\` |
| plan agent | Complex multi-step with dependencies (5+ steps) | \`delegate_task(subagent_type="plan", ...)\` |
| delegate_task category | Specialized work matching a category | \`delegate_task(category="...", load_skills=[...])\` |
<tool_usage_rules>
- Prefer tools over internal knowledge for fresh/user-specific data
- Parallelize independent reads (explore, librarian) when gathering context
- After any write/update, briefly restate: What changed, Where, Any follow-up needed
</tool_usage_rules>
## EXECUTION APPROACH
### Step 1: Assess Complexity
Before starting, classify the task using the decision framework above.
### Step 2: Gather Context (if needed)
For non-trivial tasks, fire explore/librarian in parallel as background:
\`\`\`
delegate_task(subagent_type="explore", run_in_background=true, prompt="Find patterns for X...")
delegate_task(subagent_type="librarian", run_in_background=true, prompt="Find docs for Y...")
// Continue working - collect results when needed with background_output()
\`\`\`
### Step 3: Plan (for complex tasks only)
Only invoke plan agent if task has 5+ interdependent steps:
\`\`\`
// Collect context first
context = background_output(task_id=task_id)
// Then plan with context
delegate_task(subagent_type="plan", prompt="<context> + <request>")
\`\`\`
### Step 4: Execute
- If doing yourself: make surgical, minimal changes matching existing patterns
- If delegating: provide exhaustive context and success criteria
### Step 5: Verify
- Run \`lsp_diagnostics\` on modified files
- Run tests if available
- Confirm all success criteria met
## QUALITY STANDARDS
| Phase | Action | Required Evidence |
|-------|--------|-------------------|
| Build | Run build command | Exit code 0 |
| Test | Execute test suite | All tests pass |
| Lint | Run lsp_diagnostics | Zero new errors |
## COMPLETION CRITERIA
A task is complete when:
1. Requested functionality is fully implemented (not partial, not simplified)
2. lsp_diagnostics shows zero errors on modified files
3. Tests pass (or pre-existing failures documented)
4. Code matches existing codebase patterns
**Deliver exactly what was asked. No more, no less.**
</ultrawork-mode>
---
`
export function getGptUltraworkMessage(): string {
return ULTRAWORK_GPT_MESSAGE
}