rse/ase / plugin/skills/ase-repo-diff
ase-repo-diff
VerifiedSummarize the currently staged Git changes as a human-readable, intent-grouped narrative. Use when the user wants a concise and brief report of what changed and why. Optionally can check the diff for intent coherence and show a risk and blast radius report.
help.md
View on GitHub
## NAME
`ase-repo-diff` - Summarize Diff
## SYNOPSIS
`ase-repo-diff`
[`--help`|`-h`]
[`--coherence`|`-c`]
[`--risk`|`-r`]
[`--blast`|`-b`]
## DESCRIPTION
The `ase-repo-diff` skill turns a raw Git diff into a *concise*,
*human-readable* narrative of what changed and why, *grouped by
intent* (such as *Feature*, *Improvement*, *Bugfix*, *Update*,
*Cleanup*, or *Refactor*) rather than by file. It inspects the
*staged* changes (`git diff --cached`). The result is a compact
table, one row per intent group, each naming the affected files
with their per-file `[+N/-M]` line counts - giving you the essence
of the changes at a glance.
With `--coherence`, the skill additionally *reconstructs the single
intended change* the diff is trying to accomplish - phrased as one crisp
*thesis* sentence - and then walks *every* hunk to *flag those that do
not serve it*: **scope creep** (an unrelated feature or drive-by refactor
riding along) and **stray debug** (leftover prints, commented-out code, or
disabled tests). It emits an overall **COHERENT** / **INCOHERENT** verdict
plus a table of the flagged hunks with what to do with each - keeping the
diff to a *single logical and coherent change* before it is committed.
With `--risk`, the skill additionally *scores* the same diff against a
four-axis **coupling-criticality-coverage-reversibility** rubric and
emits a *graded risk report* - one table row per axis (each scored *1*-*5*
with a one-line evidence justification drawn from the actual hunks), an
overall risk band (**LOW**, **MODERATE**, **HIGH**, or **CRITICAL**),
and one actionable *mitigation* per high-risk axis. The axes combine
with *equal weights*, and the rubric is deliberately *not tuned* to any
specific project: every score is backed by cited evidence so it remains
*overridable*, and the report is *decision support*, not a merge gate.
With `--blast`, the skill additionally renders a *blast-radius map* - a
Mermaid `flowchart` of the *touched modules* and their *reverse
dependencies*, plus a *brief impact summary*. It *extracts the touched
modules* from the changed files, *scans the repository* for the
first-party code that *imports* or *references* those modules, builds a
blast-radius graph (touched modules as origin nodes, dependents fanning
out along the edges), renders it (as an inline image where supported),
and appends a short bullet list of the per-module impact -
giving a visual sense of *what a diff endangers* before a deeper review.
For a project with `black` boxing (`project.boxing`), the scrutiny of
`--coherence`, `--risk`, and `--blast` is suppressed, and only the
intent-grouped summary is shown.
## ARGUMENTS
- `--coherence`, `-c`:
In addition to the intent-grouped summary, reconstruct the diff's
*single intended change* as one crisp *thesis* sentence and flag
*every* hunk that does *not* serve it - *scope creep* or *stray
debug* - then emit an overall **COHERENT** / **INCOHERENT** verdict
with a table of the flagged hunks.
- `--risk`, `-r`:
In addition to the intent-grouped summary, score the diff against
the *coupling-criticality-coverage-reversibility* rubric and emit a
*graded risk report* with an overall risk band and per-axis
*mitigations*. Scores are equal-weighted, evidence-backed, and
deliberately untuned to the project.
- `--blast`, `-b`:
In addition to the intent-grouped summary, render a *blast-radius
map* - a Mermaid `flowchart` of the *touched modules* and their
*reverse dependencies* - plus a *brief impact summary* of what
depends on the touched code and how far the blast reaches.
## SCENARIOS
- You want a readable, intent-grouped summary of the staged changes
- You want a diff checked for scope creep and stray debug leftovers
- You want a graded risk report of a change before committing
- You want a blast-radius map of what depends on the touched code
## EXAMPLES
Summarize the currently staged changes:
```text
❯ /ase-repo-diff
```
Summarize the staged changes and append an intent-coherence report:
```text
❯ /ase-repo-diff --coherence
```
Summarize the staged changes and append a graded risk report:
```text
❯ /ase-repo-diff --risk
```
Summarize the staged changes and append a blast-radius map:
```text
❯ /ase-repo-diff --blast
```
## SEE ALSO
[`ase-repo-commit`](../ase-repo-commit/help.md), [`ase-repo-changelog`](../ase-repo-changelog/help.md), [`ase-arch-analyze`](../ase-arch-analyze/help.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |