@rse/ase 0.0.59 → 0.0.61
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/.github/plugin/plugin.json +1 -1
- package/plugin/etc/markdownlint.yaml +2 -0
- package/plugin/meta/ase-skill.md +80 -37
- package/plugin/package.json +1 -1
- package/plugin/skills/ase-arch-analyze/SKILL.md +2 -2
- package/plugin/skills/ase-arch-discover/SKILL.md +4 -4
- package/plugin/skills/ase-code-analyze/SKILL.md +1 -1
- package/plugin/skills/ase-code-craft/SKILL.md +10 -4
- package/plugin/skills/ase-code-craft/help.md +8 -0
- package/plugin/skills/ase-code-explain/SKILL.md +6 -6
- package/plugin/skills/ase-code-insight/SKILL.md +4 -4
- package/plugin/skills/ase-code-lint/SKILL.md +9 -9
- package/plugin/skills/ase-code-refactor/SKILL.md +10 -4
- package/plugin/skills/ase-code-refactor/help.md +8 -0
- package/plugin/skills/ase-code-resolve/SKILL.md +12 -6
- package/plugin/skills/ase-code-resolve/help.md +8 -0
- package/plugin/skills/ase-docs-proofread/SKILL.md +5 -5
- package/plugin/skills/ase-meta-brainstorm/SKILL.md +220 -0
- package/plugin/skills/ase-meta-brainstorm/help.md +51 -0
- package/plugin/skills/ase-meta-changes/SKILL.md +5 -5
- package/plugin/skills/ase-meta-diaboli/SKILL.md +3 -3
- package/plugin/skills/ase-meta-diff/SKILL.md +301 -0
- package/plugin/skills/ase-meta-diff/help.md +81 -0
- package/plugin/skills/ase-meta-evaluate/SKILL.md +9 -9
- package/plugin/skills/ase-meta-why/SKILL.md +3 -3
- package/plugin/skills/ase-task-delete/SKILL.md +1 -1
- package/plugin/skills/ase-task-edit/SKILL.md +2 -2
- package/plugin/skills/ase-task-grill/SKILL.md +2 -2
- package/plugin/skills/ase-task-view/SKILL.md +2 -2
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
|
|
2
|
+
## NAME
|
|
3
|
+
|
|
4
|
+
`ase-meta-diff` - Summarize Diff
|
|
5
|
+
|
|
6
|
+
## SYNOPSIS
|
|
7
|
+
|
|
8
|
+
`ase-meta-diff`
|
|
9
|
+
[`--help`|`-h`]
|
|
10
|
+
[`--risk`|`-r`]
|
|
11
|
+
[`--blast`|`-b`]
|
|
12
|
+
|
|
13
|
+
## DESCRIPTION
|
|
14
|
+
|
|
15
|
+
The `ase-meta-diff` skill turns a raw Git diff into a *concise*,
|
|
16
|
+
*human-readable* narrative of what changed and why, *grouped by
|
|
17
|
+
intent* (such as *Feature*, *Improvement*, *Bugfix*, *Update*,
|
|
18
|
+
*Cleanup*, or *Refactor*) rather than by file. It inspects the
|
|
19
|
+
*staged* changes (`git diff --cached HEAD`). The result is a short
|
|
20
|
+
bullet list, one bullet per intent group, each naming the affected
|
|
21
|
+
files with their per-file `[+N/-M]` line counts — giving you the
|
|
22
|
+
essence of the changes at a glance.
|
|
23
|
+
|
|
24
|
+
With `--risk`, the skill additionally *scores* the same diff against a
|
|
25
|
+
four-axis **coupling-criticality-coverage-reversibility** rubric and
|
|
26
|
+
emits a *graded risk report* — one bullet per axis (each scored *1*-*5*
|
|
27
|
+
with a one-line evidence justification drawn from the actual hunks), an
|
|
28
|
+
overall risk band (**LOW**, **MODERATE**, **HIGH**, or **CRITICAL**),
|
|
29
|
+
and one actionable *mitigation* per high-risk axis. The axes combine
|
|
30
|
+
with *equal weights*, and the rubric is deliberately *not tuned* to any
|
|
31
|
+
specific project: every score is backed by cited evidence so it remains
|
|
32
|
+
*overridable*, and the report is *decision support*, not a merge gate.
|
|
33
|
+
|
|
34
|
+
With `--blast`, the skill additionally renders a *blast-radius map* — a
|
|
35
|
+
Mermaid `flowchart` of the *touched modules* and their *reverse
|
|
36
|
+
dependencies*, plus a *brief impact summary*. It *extracts the touched
|
|
37
|
+
modules* from the changed files, *scans the repository* for the
|
|
38
|
+
first-party code that *imports* or *references* those modules, builds a
|
|
39
|
+
blast-radius graph (touched modules as origin nodes, dependents fanning
|
|
40
|
+
out along the edges), dispatches the rendering to the `ase-meta-diagram`
|
|
41
|
+
sub-agent, and appends a short bullet list of the per-module impact —
|
|
42
|
+
giving a visual sense of *what a diff endangers* before a deeper review.
|
|
43
|
+
|
|
44
|
+
## ARGUMENTS
|
|
45
|
+
|
|
46
|
+
`--risk`, `-r`:
|
|
47
|
+
In addition to the intent-grouped summary, score the diff against
|
|
48
|
+
the *coupling-criticality-coverage-reversibility* rubric and emit a
|
|
49
|
+
*graded risk report* with an overall risk band and per-axis
|
|
50
|
+
*mitigations*. Scores are equal-weighted, evidence-backed, and
|
|
51
|
+
deliberately untuned to the project.
|
|
52
|
+
|
|
53
|
+
`--blast`, `-b`:
|
|
54
|
+
In addition to the intent-grouped summary, render a *blast-radius
|
|
55
|
+
map* — a Mermaid `flowchart` of the *touched modules* and their
|
|
56
|
+
*reverse dependencies* — plus a *brief impact summary* of what
|
|
57
|
+
depends on the touched code and how far the blast reaches.
|
|
58
|
+
|
|
59
|
+
## EXAMPLES
|
|
60
|
+
|
|
61
|
+
Summarize the currently staged changes:
|
|
62
|
+
|
|
63
|
+
```text
|
|
64
|
+
❯ /ase-meta-diff
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Summarize the staged changes and append a graded risk report:
|
|
68
|
+
|
|
69
|
+
```text
|
|
70
|
+
❯ /ase-meta-diff --risk
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Summarize the staged changes and append a blast-radius map:
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
❯ /ase-meta-diff --blast
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## SEE ALSO
|
|
80
|
+
|
|
81
|
+
`ase-meta-commit`, `ase-meta-changes`, `ase-arch-analyze`.
|
|
@@ -33,7 +33,7 @@ multi-*criteria* decision matrix.
|
|
|
33
33
|
and do not output anything else:
|
|
34
34
|
|
|
35
35
|
<template>
|
|
36
|
-
|
|
36
|
+
<ase-tpl-bullet-secondary/> **REASON**: *<reason/>*
|
|
37
37
|
</template>
|
|
38
38
|
</step>
|
|
39
39
|
|
|
@@ -47,7 +47,7 @@ multi-*criteria* decision matrix.
|
|
|
47
47
|
executing any further steps:
|
|
48
48
|
|
|
49
49
|
<template>
|
|
50
|
-
|
|
50
|
+
<ase-tpl-bullet-signal/> **ERROR: INSUFFICIENT ALTERNATIVES**: at least two are required for a comparison!
|
|
51
51
|
</template>
|
|
52
52
|
|
|
53
53
|
- For each alternative <alternative-K/> (K=1-N), decide whether
|
|
@@ -82,7 +82,7 @@ multi-*criteria* decision matrix.
|
|
|
82
82
|
executing any further steps:
|
|
83
83
|
|
|
84
84
|
<template>
|
|
85
|
-
|
|
85
|
+
<ase-tpl-bullet-signal/> **ERROR: INCOMPARABLE ALTERNATIVES**: *<class-of-alternatives/>*
|
|
86
86
|
|
|
87
87
|
<for items="<alternative-J/> [...]">
|
|
88
88
|
⚑ **<item/>** (*member of a different class*)
|
|
@@ -94,7 +94,7 @@ multi-*criteria* decision matrix.
|
|
|
94
94
|
anything else:
|
|
95
95
|
|
|
96
96
|
<template>
|
|
97
|
-
|
|
97
|
+
<ase-tpl-bullet-normal/> **ALTERNATIVES**: *<class-of-alternatives/>*
|
|
98
98
|
|
|
99
99
|
| ⚑ *Alternative* | ⚖ *Hint* |
|
|
100
100
|
| :--------------------- | :-------- |
|
|
@@ -161,7 +161,7 @@ multi-*criteria* decision matrix.
|
|
|
161
161
|
alternative* <alternative-K/> (K=1-N).
|
|
162
162
|
|
|
163
163
|
<template>
|
|
164
|
-
|
|
164
|
+
<ase-tpl-bullet-normal/> **EVALUATION**: *Weighted Multi-Criteria Decision Matrix*
|
|
165
165
|
|
|
166
166
|
| ⦿ *Criteria* | ⚖ *Weight* | ⚑ **<alternative-1/>** | [...alternatives 2-(N-1)...] | ⚑ **<alternative-N/>** |
|
|
167
167
|
| :------------ | ----------: | ---------------------: | ---------------------------: | ---------------------: |
|
|
@@ -217,7 +217,7 @@ multi-*criteria* decision matrix.
|
|
|
217
217
|
else:
|
|
218
218
|
|
|
219
219
|
<template>
|
|
220
|
-
|
|
220
|
+
<ase-tpl-bullet-signal/> **ERROR**: ✘ *MULTIPLE BEST ALTERNATIVES FOUND*,
|
|
221
221
|
⚠ *Please give some hints on the criteria to ensure a single best alternative!*
|
|
222
222
|
</template>
|
|
223
223
|
|
|
@@ -226,7 +226,7 @@ multi-*criteria* decision matrix.
|
|
|
226
226
|
else:
|
|
227
227
|
|
|
228
228
|
<template>
|
|
229
|
-
|
|
229
|
+
<ase-tpl-bullet-signal/> **BEST ALTERNATIVE**: ⚑ **<alternative-K/>**
|
|
230
230
|
⚠ *ATTENTION: small distance to second best alternative!*
|
|
231
231
|
</template>
|
|
232
232
|
|
|
@@ -236,7 +236,7 @@ multi-*criteria* decision matrix.
|
|
|
236
236
|
output anything else:
|
|
237
237
|
|
|
238
238
|
<template>
|
|
239
|
-
|
|
239
|
+
<ase-tpl-bullet-signal/> **BEST ALTERNATIVE**: ⚑ **<alternative-K/>**
|
|
240
240
|
⚠ *ATTENTION: all alternatives rate negatively; this is the least-bad choice, not a strong winner!*
|
|
241
241
|
</template>
|
|
242
242
|
|
|
@@ -244,7 +244,7 @@ multi-*criteria* decision matrix.
|
|
|
244
244
|
just the following <template/> and do not output anything else:
|
|
245
245
|
|
|
246
246
|
<template>
|
|
247
|
-
|
|
247
|
+
<ase-tpl-bullet-signal/> **BEST ALTERNATIVE**: ⚑ **<alternative-K/>**
|
|
248
248
|
</template>
|
|
249
249
|
</step>
|
|
250
250
|
</flow>
|
|
@@ -31,7 +31,7 @@ addressing surface-level symptoms.
|
|
|
31
31
|
State the problem statement.
|
|
32
32
|
|
|
33
33
|
<template>
|
|
34
|
-
|
|
34
|
+
<ase-tpl-bullet-signal/> **PROBLEM**: <problem/>
|
|
35
35
|
</template>
|
|
36
36
|
</step>
|
|
37
37
|
|
|
@@ -46,7 +46,7 @@ addressing surface-level symptoms.
|
|
|
46
46
|
Consider technical, domain-specific, process-related, or organizational causes.
|
|
47
47
|
|
|
48
48
|
<template>
|
|
49
|
-
|
|
49
|
+
<ase-tpl-bullet-secondary/> **WHY <item/>**: <answer/>
|
|
50
50
|
</template>
|
|
51
51
|
|
|
52
52
|
Then, for the next iteration set <question/> now to be the last <answer/>.
|
|
@@ -61,7 +61,7 @@ addressing surface-level symptoms.
|
|
|
61
61
|
For the proposed solution, optionally directly propose corresponding source code changes.
|
|
62
62
|
|
|
63
63
|
<template>
|
|
64
|
-
|
|
64
|
+
<ase-tpl-bullet-signal/> **SOLUTION**: <solution/>
|
|
65
65
|
</template>
|
|
66
66
|
</step>
|
|
67
67
|
</flow>
|
|
@@ -326,9 +326,9 @@ Set <content-dirty>true</content-dirty>.
|
|
|
326
326
|
Use the following <template/>:
|
|
327
327
|
|
|
328
328
|
<template>
|
|
329
|
-
|
|
329
|
+
<ase-tpl-head title="TASK-PLAN"/>
|
|
330
330
|
<content/>
|
|
331
|
-
|
|
331
|
+
<ase-tpl-foot title="TASK-PLAN"/>
|
|
332
332
|
</template>
|
|
333
333
|
|
|
334
334
|
4. *Determine next step*:
|
|
@@ -143,7 +143,7 @@ Procedure
|
|
|
143
143
|
1. Output the following <template/>:
|
|
144
144
|
|
|
145
145
|
<template>
|
|
146
|
-
|
|
146
|
+
<ase-tpl-bullet-signal/> ASPECT <N/>/<n/>: **<aspect-N/>**, QUESTION: **<question-N/>**
|
|
147
147
|
</template>
|
|
148
148
|
|
|
149
149
|
2. Determine the answer alternatives:
|
|
@@ -164,7 +164,7 @@ Procedure
|
|
|
164
164
|
4. Output the following <template/>:
|
|
165
165
|
|
|
166
166
|
<template>
|
|
167
|
-
|
|
167
|
+
<ase-tpl-bullet-normal/> ASPECT <N/>/<n/>: **<aspect-N/>**, ANSWER: **<answer-N/>**
|
|
168
168
|
</template>
|
|
169
169
|
|
|
170
170
|
3. Finally, update the in <plan/> based on all answers <answer-N/>.
|
|
@@ -82,9 +82,9 @@ explicitly requested by this procedure via outputs based on a <template/>!
|
|
|
82
82
|
<content/> here.
|
|
83
83
|
|
|
84
84
|
<template>
|
|
85
|
-
|
|
85
|
+
<ase-tpl-head title="TASK-PLAN"/>
|
|
86
86
|
<content/>
|
|
87
|
-
|
|
87
|
+
<ase-tpl-foot title="TASK-PLAN"/>
|
|
88
88
|
</template>
|
|
89
89
|
</if>
|
|
90
90
|
|