Egm Resolve

google/elephant-goldfish-model/skills/egm-resolve

作者 google72d06f52a2482885d9a64bd24b291c6e8628942cApache-2.021K 個星標收錄於 2026年11月17日更新於 2026年11月17日儲存庫今天更新

The Elephant resolution skill. Ingests flat deficiency reports from concurrent Goldfish reviewers, applies automated fixes for PROPOSE FIX items via UI multiple-choice gates, and presents interactive negotiation/re-sync checkpoints.

AI 產生的概覽

處理審閱者提出的文件缺陷:分類為質疑、上呈、建議修正或忽略,並經使用者確認後套用修改。

功能
接收目標檔案、行範圍以及來自多個並行審閱者的扁平化問題清單,為每條問題指定唯一類別:CONTEST(質疑)、ESCALATE(上呈)、PROPOSE FIX(建議修正)或 DECLINE(忽略)。接著產出名為 goldfish_review_report.md 的優先順序報告,包含每條問題的理由與精確的修改建議。之後暫停等待使用者選擇全部接受、不做修改繼續、逐條互動確認或提供自訂指示,套用被接受的修改,並在交接前重新驗證檔案結構。
適用情境
適用於文件已由多位審閱者審閱、需要對其發現進行分流與處理的情境。也適合要求修改必須經人工明確核准後才寫入檔案的工作流程,以及需要清楚交接摘要的編排迴圈。
執行需求
僅為指示,不附帶指令碼。需要檔案讀取與編輯工具、可寫入的工作目錄或產出目錄以儲存報告,以及參與核准環節的互動使用者。建議在產生該文件的持續性工作階段中執行。

Goldfish Review: Resolve

When running in Codex or ChatGPT Work, first read Codex integration. In Claude Code or Cowork, read ${CLAUDE_PLUGIN_ROOT}/docs/claude.md first.

Overview

This skill instructs the agent on how to operate within the primary Elephant context window to parse flat deficiency reports from concurrent Goldfish reviewers. It defends accurate design choices, applies automated textual repairs, and manages interactive negotiation checkpoints.

Prerequisites & Context Strategy

  • Context Recommendation (Elephant Memory): This skill should be run in the persistent conversation session that generated the target document (the Elephant) to recall earlier reasoning and craft higher-quality fixes.

Inputs

The caller or orchestration driver provides exactly these parameters:

  • TargetFile: Absolute or relative path to target document.
  • LineRange: Exact line numbers (or full file).
  • FindingsList: Aggregated flat list of findings from Goldfish reviewers.

Execution Workflow

Step 1: Intake Validation & Gather Context

  1. Hybrid Execution UX: Detect if execution arguments are present:

    • Automated Mode: If all parameters are provided, execute silently as a subprocess.
    • Standalone Human Mode: If parameters are omitted, trigger a friendly onboarding flow. Prompt for one piece of input at a time, waiting for the user's response after each turn. Once all inputs are specified, display the final setup and verify the user is ready to continue.
  2. Read TargetFile at LineRange by reading it and parse the FindingsList.

Step 2: Evaluate & Categorize

Give each finding exactly one category:

  • CONTEST: The critique is inaccurate or relies on a misunderstanding of the codebase. Cite evidence that the reviewer could read: a file and symbol, or a decision recorded in the document.
  • ESCALATE: The critique is inaccurate, but the evidence is outside every file the reviewer could read (for example, a team convention or a verbal decision). State that fact. Do not fix the finding. Give it to the user.
  • PROPOSE FIX: The critique is valid. Define precise textual replacements or structural formatting adjustments to resolve the gap.
  • DECLINE: The finding is a Nit. Record it. Do not fix it. You can use PROPOSE FIX for a Nit if the fix is worth it.

Apply these rules:

  • A contest must be checkable. "This was intentional" is not evidence. If you cannot cite evidence the reviewer could read, use ESCALATE or PROPOSE FIX.
  • Do not add context only to satisfy a reviewer. Add context when a human reader of the document needs it. If only a zero-context subagent needs it, use ESCALATE.
  • Do not contest a comprehension gap. If a fresh reader could not follow the document, the document is missing context.
  • Do not change a severity. If you think a Blocker is a Nit, CONTEST it and state the reason.
  • You wrote the document under review. A wish to contest is not evidence that the reviewer is wrong.

Step 3: Report Fixes

Construct the final report and save it named goldfish_review_report.md in the working directory (or your harness's artifact directory, if it has one) using your file-writing tool. Use this layout:

markdown
# Goldfish Annotated Review Report
**Target:** `[TargetFile]` (`[LineRange]`)
## Prioritized Findings & AI Suggestions
{{range findings, ordered by Severity}}### [Issue 1] [`[ReviewerPersona]`] - Severity: [Blocker | Major | Nit]*   **Affected Scope:** [Lines Start-End]([RelativePath]#L[Start]-L[End]) ([Sub-header])*   **Discrepancy Description:** [copied from FindingsList]*   **Rationale:** [copied from FindingsList]*   ***AI Suggestion:*** [CONTEST | ESCALATE | PROPOSE FIX | DECLINE]*   ***Justification:*** [Detailed reason]*   ***Proposed Edit:***    *   Location: [Line/Header]    *   Change: [Precise replacement string or deletion note]{{end}}

Step 4: Interactive Resolution Gate

If any finding is ESCALATE, list those findings first in the chat message. They need the user's knowledge, not only approval.

Before proceeding, output a visible chat message to the user: *"I have compiled the audit findings into goldfish_review_report.md. Please review the findings there and choose how you would like to proceed:

  • Comment directly on the file: Review goldfish_review_report.md in chat or the file and leave comments/edits to approve, reject, or contest specific items.
  • Auto accept: Reply "auto accept" to batch-apply all proposed fixes (skipping contested items).
  • Continue to next phase: Reply "continue" or "no changes" to proceed without applying fixes.
  • Interactive breakdown: Reply "interactive breakdown" for a guided, item-by-item walkthrough in chat with detailed explanations for each proposed edit or contested finding before making decisions.
  • Custom instruction / Wildcard request: Reply with any custom instruction, question, or out-of-band request."*

You MUST immediately yield active execution by calling zero tools in this turn payload. You must stop execution and go idle, waiting for the human developer to comment on/edit the artifact or reply in the chat.

Interpret the user's action/response as follows:

  • "Auto accept" / "Accept all suggestions" / User clicks "Proceed" without contesting: Apply all fixes where the AI suggestion was PROPOSE FIX directly to TargetFile at LineRange in a single batch using your file-editing tool. Any items categorized as CONTEST, ESCALATE, or DECLINE are explicitly bypassed. Then proceed to Step 5.

  • "Continue to next phase" / "No changes": Do not apply any automated fixes. Then proceed to Step 5.

  • "Interactive breakdown": Enter a sequential breakdown loop over ALL finding items (all categories except DECLINE):

    1. For each item i, output a visible chat message formatting the full finding details and explanation in rich markdown:

      markdown
      ### Breakdown Item [i]: [Issue Title] [`[ReviewerPersona]`]* **Scope:** [Lines Start-End]([RelativePath]#L[Start]-L[End]) ([Sub-header])* **Description:** [Description]* **AI Suggestion:** [CONTEST | ESCALATE | PROPOSE FIX]* **Explanation & Justification:** [Detailed reason and background explaining why the fix is proposed or why the finding is contested]* **Proposed Edit:** [Precise replacement text or deletion note]

      Then prompt the user in chat for their decision on this item (calling zero tools and going idle):

      • If PROPOSE FIX: Ask the user to reply with Accept proposed fix, Skip / ignore, or Discuss.
      • If CONTEST: Ask the user to reply with Skip / agree with contest, Overrule contest (propose fix), or Discuss.
      • If ESCALATE: Ask the user to reply with Confirm (no change), Add the fact to the document, or Discuss.
    2. Record the user's decisions in an internal memory checklist (e.g., Item 1: Accepted, Item 2: Ignored, Item 3: Overruled). Do NOT call any file editing tools during this sequential loop.

    3. Once all items have been decided, summarize the accepted edits, execute them using your file-editing tool, and proceed to Step 5.

  • Custom instruction / Out-of-band edit: If the user provides targeted instructions, apply them and proceed.

Step 5: Post-Resolution Synchronization & Exit

  1. Re-verify Lines: If changes were made to TargetFile, verify that the file remains structurally coherent and valid markdown.
  2. Mark the report as resolved (add a Status: resolved line at the top).
  3. Handoff: Exit cleanly back to the caller (such as egm-review-loop) with the count of accepted fixes, contested items, escalated items, declined items, and remaining unaddressed issues.

來源與署名

來源:google/elephant-goldfish-model位於skills/egm-resolve提交72d06f5

授權條款: Apache-2.0

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

在 README 中新增徽章

向讀者展示該技能已收錄於 SourceWeft,徽章連結到本頁。

「Listed on SourceWeft」徽章預覽
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-google-elephant-goldfish-model-egm-resolve-skills-egm-resolve-736b313ffc9d3682.svg)](https://sourceweft.com/skills/gh-google-elephant-goldfish-model-egm-resolve-skills-egm-resolve-736b313ffc9d3682?utm_source=readme&utm_medium=badge)

檢舉或申請下架

更多來自 google/elephant-goldfish-model 的技能

Egm Drift Report

google

精選

將設計文件與 README 和程式碼庫比對,產出列出所有差異的 Markdown 報告。

軟體開發21K今天更新

Egm Review Loop

google

精選

Executes the Antagonistic-Review process from the Elephant-Goldfish Model (EGM) via an automated multi-agent review loop to audit documents against qualitative standards and structural templates, and automatically apply approved fixes. Use when reviewing design docs, READMEs, feature specifications, implementation plans, or verifying document completeness and tone.

待分類21K今天更新

Egm Draft

google

精選

Drafts a design document section-by-section using the concepts brief from egm-brainstorm (or user notes). This is the second step in the Elephant-Goldfish (EGM) feature flow. Use when you are ready to write a design doc after aligning on requirements + solution.

待分類21K今天更新

Egm Bootstrap

google

精選

為儲存庫目錄樹產生並修正符合 EGM 規範的 README.md 契約檔案,可平行使用子代理。

文件與辦公21K今天更新

Egm Brainstorm

google

精選

Interactive ideation and brainstorming skill for the Elephant & Goldfish Model (EGM). Helps turn half-baked concepts into structured hypotheses via clarifying questions, review, and iterative refinement. Produces an RFC summary for human review or more detailed design with egm-draft.

待分類21K今天更新

Egm Review

google

精選

Orchestrates the EGM Goldfish Review Protocol. Used as part of the EGM process to perform design document reviews. Executes five review phases: Initial Zoom Out Review, Comprehension Review, Design Critique, Intermediate Zoom Out Review, and Implementation Readiness.

待分類21K今天更新