Copilot Review Delta Brief

简体中文 · Supports iPolloWork

Copilot Review Delta Brief is an offline iPolloWork Skill for comparing two supplied GitHub Copilot code-review snapshots. It creates a bilingual reviewer handoff that separates confirmed open, resolved, and new findings from items whose identity cannot be matched safely.

Who it helps

It is designed for maintainers, release engineers, and security reviewers who need to understand how a Copilot review changed after new commits without losing the evidence behind each status claim.

Features

• Matches findings only by an explicit identical thread URL or stable finding ID.
• Reports open, resolved, new, and identity-uncertain classifications separately.
• Preserves location, severity, snapshot evidence, and the next reviewer action.
• Produces a concise bilingual Markdown brief suitable for a pull-request handoff.
• Works entirely on local supplied files and uses no account, network, executable, or credential.

Workflow

1. Export or copy the older and newer review summaries into two local Markdown files.
2. Ask the installed Skill to compare those files.
3. Review every identity-uncertain item against a stable thread URL or finding ID.
4. Attach the finished brief to the review or release handoff.

Inputs and outputs

Inputs are two text or Markdown review snapshots. Stable IDs, thread URLs, state, file, line, severity, summary, and evidence are useful when present. The output is one Markdown brief containing bilingual counts, a delta table, uncertain candidates, actions, and an evidence note. It does not query GitHub or modify pull requests.

End-to-end example

Open examples/review-before.md and examples/review-after.md in an iPolloWork project, then ask:

Use Copilot Review Delta Brief to compare examples/review-before.md with examples/review-after.md. Save examples/review-after-delta-brief.md.

The expected result is in examples/expected-delta-brief.md. thread-104 is resolved because both snapshots share its ID and URL and the newer snapshot says resolved. thread-130 is new. The identity-free auth item remains uncertain even though its wording resembles thread-117.

Install and use in iPolloWork

1. Download copilot-review-delta-brief-1.0.0.ipollowork-plugin from Releases.
2. In iPolloWork choose Extensions → Plugins → Add → File, select the package, and check publisher Sevaschan, version 1.0.0, and one Skill resource.
3. Install the package and keep the Skill enabled. Start a new local-project task if an existing task does not reload it.
4. Name the two snapshot paths and explicitly ask to use Copilot Review Delta Brief. Review the generated file before sharing it.
5. For the local-Skill route, unzip copilot-review-delta-brief-1.0.0-skill.zip and select the directory that directly contains SKILL.md.

Build and package

Node.js 22+ and the system zip command are required only to rebuild artifacts.

npm test
npm run package

The release includes the installer, direct Skill ZIP, source ZIP, and SHA256SUMS.txt. Verify downloads with shasum -a 256 -c SHA256SUMS.txt.

Tested environment and limits

Version 1.0.0 targets iPolloWork 0.50.12 on macOS arm64 with the OpenCode engine. It is an ordinary declarative Skill with source.trusted=false and no permissions. Desktop acceptance imports the package, loads the Skill, runs the example, and inspects the generated brief. The Skill cannot verify live GitHub state, judge whether code is correct, recover missing finding IDs, or prove release readiness.

FAQ

Why not match findings by wording and file? Those fields can change or collide. The Skill keeps such items uncertain until a stable identity is supplied.

Does a missing newer finding mean it was resolved? No. Absence alone is not resolution evidence.

Can it update review threads? No. It produces a local handoff document only.