@rse/ase 0.9.50 → 0.9.52

package/plugin/skills/ase-code-dissect/help.md

@@ -0,0 +1,121 @@
+
+##  NAME
+
+`ase-code-dissect` - Dissect a Change Set
+
+##  SYNOPSIS
+
+`ase-code-dissect`
+    [`--help`|`-h`]
+    [`--max-parts`|`-m` *count*]
+    [`--staged`|`-s`]
+    [`--dry`|`-d`]
+    [`--force`|`-f`]
+    [*dissect-hint*]
+
+##  DESCRIPTION
+
+The `ase-code-dissect` skill treats the current Git change set as an
+*epic* and *dissects* it domain-wise and logically into *cohesive
+parts*. Each part is a self-contained unit of change with a single
+coherent purpose, so it can be reviewed and committed *atomically* and
+*independently* of the others.
+
+The change set is captured from the working copy (`git diff`), with
+untracked files folded in *read-only*, or -- under `--staged`/`-s` --
+from the Git index (`git diff --cached HEAD`). The dissection follows a
+strict ruleset: at least *2* and at most *count* parts are derived,
+*every* hunk is assigned to *exactly one* part, mutually dependent hunks
+are kept together, all hunks of one file normally stay in the same part,
+and nothing beyond the actual change set is invented. The cut follows
+the *semantics* of the change, not its technical structure -- a split by
+file, directory, or technical layer is usually *not* the intended one.
+If the change set carries only a single cohesive purpose, it is reported
+as *not dissectable* and nothing is created.
+
+An optional *dissect-hint* steers *how* the change set is split -- which
+changes belong together, along which axis to cut, or how many parts to
+aim at. It is especially useful after a `--dry` run showed an unintended
+dissection. The hint overrides the default grouping, but never the
+ruleset itself.
+
+The derived parts are first reported as a *dissection table* (part
+number, worktree id, scope, and rationale). Then -- unless `--dry` is
+given -- each part's patch is written to a temporary file and applied
+inside a *fresh Git WorkTree* `.ase/worktree/<project-id>-<feature-slug>`,
+whose branch carries the same name and is created from `HEAD`. If a
+`CHANGELOG.md` file exists, a matching entry summarizing that part is
+added *inside* the worktree.
+
+Every part stays *uncommitted*, a failing `git apply` is reported for
+that part while the remaining parts continue, and the *original working
+copy is never mutated*.
+
+Note that the working-copy patch (without `--staged`) is taken relative
+to the Git *index* while the worktrees are created from `HEAD`. So if
+changes are *also* staged, the affected part patches may not apply
+cleanly and are then reported as failed; stage everything and use
+`--staged` in that situation.
+
+##  OPTIONS
+
+`--max-parts`|`-m` *count*:
+    Upper bound for the number of derived parts (default: `8`). The
+    lower bound is always `2`, because fewer parts are no dissection.
+
+`--staged`|`-s`:
+    Dissect the *staged* changes (the Git index against `HEAD`) instead
+    of the working copy changes. Untracked files are then *not* folded
+    in, because they are by definition not part of the index.
+
+`--dry`|`-d`:
+    *Report only* -- print the dissection table but create *no*
+    artifacts at all, so the decision stays fully reversible. Note that
+    this meaning differs from `--dry`/`-d` in `ase-code-craft`, where it
+    instead omits the `##  VERIFICATION` section of the composed plan.
+
+`--force`|`-f`:
+    Remove and re-create already existing worktrees and branches of the
+    derived names. Without this option, the skill detects colliding
+    targets *before* writing anything, reports them, and stops with
+    status *targets exist*.
+
+##  ARGUMENTS
+
+*dissect-hint*:
+    A free-text hint telling *how* the change set should be split. If
+    omitted, the parts are derived from the change set alone.
+
+The worktree names are *not* argument-driven: they are always derived
+from the *current* project id and the per-part feature slug.
+
+##  EXAMPLES
+
+Dissect the current working copy changes:
+
+```text
+❯ /ase-code-dissect
+```
+
+Preview the dissection of the staged changes into at most four parts:
+
+```text
+❯ /ase-code-dissect --staged --dry --max-parts 4
+```
+
+Re-dissect the changes, re-creating the previously created worktrees:
+
+```text
+❯ /ase-code-dissect --force
+```
+
+Dissect the changes along an explicitly given axis:
+
+```text
+❯ /ase-code-dissect keep the plugin and tool changes in separate parts
+```
+
+##  SEE ALSO
+
+[`ase-task-dissect`](../ase-task-dissect/help.md), [`ase-meta-diff`](../ase-meta-diff/help.md), [`ase-meta-review`](../ase-meta-review/help.md),
+[`ase-meta-changelog`](../ase-meta-changelog/help.md), [`ase-meta-commit`](../ase-meta-commit/help.md).

package/plugin/skills/ase-code-explain/SKILL.md

@@ -15,9 +15,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-explain">
+<purpose name="ase-code-explain">
 Explain Source Code
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-code-explain">
     $ARGUMENTS

package/plugin/skills/ase-code-insight/SKILL.md

@@ -20,9 +20,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-insight">
+<purpose name="ase-code-insight">
 Project Insight
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-code-insight">
     $ARGUMENTS

package/plugin/skills/ase-code-lint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-code-lint
-argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(LOW|MEDIUM|HIGH)] <source-reference>"
+argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(LOW|MEDIUM|HIGH)] [--include|-i=<aspect>[,...]] [--exclude|-e=<aspect>[,...]] <source-reference>"
 description: >
     Lint source code for potential code quality problems.
     Use when the user wants to "lint" or "check" source code.
@@ -14,13 +14,13 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-lint">
+<purpose name="ase-code-lint">
 Lint Source Code
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-lint"
-    arg2="--auto|-a --severity|-S=(LOW|MEDIUM|HIGH)">
+    arg2="--auto|-a --severity|-S=(LOW|MEDIUM|HIGH) --include|-i=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20)... --exclude|-e=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20)...">
     $ARGUMENTS
 </expand>
 
@@ -48,7 +48,31 @@ related to a set of code quality aspects.
 
     </if>
 
-    First, use the following <template/> to give a hint on this step:
+    First, determine the *effective aspect set* <aspects/>, i.e., the
+    code quality aspects which are checked at all. For this, parse
+    <getopt-option-include/> and <getopt-option-exclude/> as
+    comma-separated token lists, silently dropping the `none` sentinel
+    and any empty token. If a token <token/> is *not* one of the aspect
+    ids `A01`...`A20`, only output the following <template/> and then
+    *STOP* the entire flow (do not perform any further steps):
+
+    <template>
+    ⧉ **ASE**: ✪ skill: **ase-code-lint**, ▶ ERROR: invalid aspect id: **<token/>**
+    </template>
+
+    Otherwise set <aspects/> to *all* twenty aspect ids `A01`...`A20`
+    if both lists are empty, to the *include* list if only it is
+    non-empty, to all twenty *minus* the *exclude* list if only it is
+    non-empty, and to the *include* list *minus* the *exclude* list if
+    both are non-empty. If the resulting <aspects/> is *empty*, only
+    output the following <template/> and then *STOP* the entire flow
+    (do not perform any further steps):
+
+    <template>
+    ⧉ **ASE**: ✪ skill: **ase-code-lint**, ▶ ERROR: options `--include` and `--exclude` cancel out to an empty aspect set
+    </template>
+
+    Then, use the following <template/> to give a hint on this step:
 
     <template>
     <ase-tpl-bullet-secondary/> **LINT INVESTIGATION**
@@ -72,16 +96,17 @@ related to a set of code quality aspects.
         Agent(
             description:       "Lint Investigation (<batch-index/>/<batch-count/>)",
             subagent_type:     "ase:ase-code-lint",
-            prompt:            <batch/>,
+            prompt:            "<aspects/> <batch/>",
             run_in_background: false
         )
     ```
 
-    Here <batch/> is the space-separated list of the source code file
-    paths of the corresponding batch, <batch-index/> is the 1-based
-    index of that batch, and <batch-count/> is the total number of
-    batches, so that each parallel invocation is distinguishable in
-    the progress display.
+    Here <aspects/> is the comma-separated list of the effective aspect
+    ids (without any spaces), <batch/> is the space-separated list of
+    the source code file paths of the corresponding batch,
+    <batch-index/> is the 1-based index of that batch, and
+    <batch-count/> is the total number of batches, so that each
+    parallel invocation is distinguishable in the progress display.
 
     Parse the result message of each `Agent` tool invocation as a JSON
     array and concatenate all those arrays. Then *deduplicate* the
@@ -104,6 +129,12 @@ related to a set of code quality aspects.
     *silently drop* all other problems. With the default floor `LOW`, all
     problems are kept. `ACCEPTED` problems are *never* dropped.
 
+    Finally, sort the surviving problems in <problems/> by their
+    `severity` field from highest to lowest in the fixed order `HIGH`,
+    `MEDIUM`, `LOW`, `ACCEPTED`, so the subsequent reporting starts with
+    the most severe problem. Within the same severity, keep the
+    `file`/`line` order established above.
+
     You *MUST* *NOT* output anything else in this STEP 1.
 
     </step>
@@ -443,7 +474,7 @@ related to a set of code quality aspects.
 
         <if condition="<getopt-option-auto/> is not equal `true`">
         <ase-tpl-hint level="verbose">
-        Use `/ase-code-lint --auto` to apply all corrections unattended, and `--severity` to raise the reporting floor.
+        Use `/ase-code-lint --auto` to apply all corrections unattended, `--severity` to raise the reporting floor, and `--include`/`--exclude` to narrow the checked aspects.
         </ase-tpl-hint>
         </if>
 

package/plugin/skills/ase-code-lint/help.md

@@ -9,6 +9,8 @@
     [`--help`|`-h`]
     [`--auto`|`-a`]
     [`--severity`|`-S`=(`LOW`|`MEDIUM`|`HIGH`)]
+    [`--include`|`-i`=*aspect*[`,`...]]
+    [`--exclude`|`-e`=*aspect*[`,`...]]
     *source-reference*
 
 ##  DESCRIPTION
@@ -25,6 +27,22 @@ correction interactively (or refine it via a free-text hint, which
 re-proposes the correction without limit) or - with `--auto` - applies
 all corrections automatically.
 
+By default all twenty code quality aspects are checked. The `--include`
+and `--exclude` options narrow this to an *effective aspect set*: with
+`--include` only, exactly the listed aspects are checked; with
+`--exclude` only, all aspects except the listed ones; with both, the
+included ones minus the excluded ones. An unknown aspect id, or a
+combination which cancels out to an empty set, aborts the skill with an
+error. The twenty aspect ids are:
+
+```text
+A01 FORMATTING     A06 REDUNDANCY       A11 TYPING          A16 SECURITY
+A02 COMPREHENSION  A07 PATTERNS         A12 ERROR-HANDLING  A17 ARCHITECTURE
+A03 CLEANLINESS    A08 COMPLICATEDNESS  A13 MEMORY-LEAK     A18 LOGIC
+A04 SPELLING       A09 CONCISENESS      A14 CONCURRENCY     A19 FLOW
+A05 COMPLEXITY     A10 SMELLS           A15 PERFORMANCE     A20 DEAD-CODE
+```
+
 ##  OPTIONS
 
 `--auto`|`-a`:
@@ -35,7 +53,19 @@ all corrections automatically.
     Set the *severity floor* (default `LOW`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `LOW` keeps all findings; `ACCEPTED` findings are
-    never suppressed.
+    never suppressed. Surviving findings are reported in *descending
+    severity* order `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the
+    `file`/`line` order within the same severity.
+
+`--include`|`-i`=*aspect*[`,`...]:
+    Restrict the checked code quality aspects to the given
+    comma-separated list of aspect ids (e.g. `A01,A04`). Without this
+    option, all twenty aspects are checked.
+
+`--exclude`|`-e`=*aspect*[`,`...]:
+    Remove the given comma-separated list of aspect ids from the checked
+    code quality aspects. Applied *after* `--include`, so `-i A01,A02 -e
+    A02` checks `A01` only.
 
 ##  ARGUMENTS
 
@@ -62,6 +92,18 @@ Lint a directory, reporting only `MEDIUM` and `HIGH` findings:
 ❯ /ase-code-lint -S MEDIUM src/handlers/
 ```
 
+Lint a source file for the formatting and spelling aspects only:
+
+```text
+❯ /ase-code-lint -i A01,A04 src/server.ts
+```
+
+Lint a directory for all aspects except dead code:
+
+```text
+❯ /ase-code-lint --exclude A20 src/handlers/
+```
+
 ##  SEE ALSO
 
 [`ase-code-analyze`](../ase-code-analyze/help.md), [`ase-code-resolve`](../ase-code-resolve/help.md), [`ase-code-refactor`](../ase-code-refactor/help.md),

package/plugin/skills/ase-code-refactor/SKILL.md

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-refactor">
+<purpose name="ase-code-refactor">
 Refactor Source Code
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-refactor"

package/plugin/skills/ase-code-resolve/SKILL.md

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-resolve">
+<purpose name="ase-code-resolve">
 Resolve Problem
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-resolve"

package/plugin/skills/ase-docs-distill/SKILL.md

@@ -16,9 +16,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-docs-distill">
+<purpose name="ase-docs-distill">
 Distill Key Points
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-docs-distill"

package/plugin/skills/ase-docs-proofread/SKILL.md

@@ -14,9 +14,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-docs-proofread">
+<purpose name="ase-docs-proofread">
 Analyze documents for spelling, punctuation, or grammar errors
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-docs-proofread"

package/plugin/skills/ase-help-intent/SKILL.md

@@ -20,9 +20,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-help-intent">
+<purpose name="ase-help-intent">
 Match an Intent to an ASE Command
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-help-intent"

package/plugin/skills/ase-help-skill/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-help-skill">
+<purpose name="ase-help-skill">
 Show the Manual Page of an ASE Skill
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-help-skill"

package/plugin/skills/ase-help-skill/catalog.md

@@ -6,6 +6,7 @@
 ⎈   **RESEARCH**
 ○   `ase-meta-search`:     Search the Internet/Web
 ○   `ase-meta-proximity`:  Determine the Conceptual Proximity of a Topic
+○   `ase-meta-quotes`:     Find Quotes on a Topic
 ○   `ase-meta-brainstorm`: Collaboratively Brainstorm a Topic
 ○   `ase-meta-chat`:       Query Foreign LLM for Chat
 ○   `ase-meta-quorum`:     Query Multiple AIs for Quorum Answer
@@ -40,6 +41,7 @@
 ○   `ase-meta-commit`:     Git Commit Message
 ○   `ase-meta-diff`:       Summarize Diff
 ○   `ase-meta-review`:     Review Staged Changes
+○   `ase-code-dissect`:    Dissect a Change Set
 
 ⎈   **TASK MANAGEMENT**
 ○   `ase-task-id`:         Configure Task Id
@@ -48,6 +50,7 @@
 ○   `ase-task-edit`:       Iteratively Edit a Task Plan
 ○   `ase-task-grill`:      Iteratively Grill a Task Plan
 ○   `ase-task-condense`:   Condense a Task Plan
+○   `ase-task-dissect`:    Dissect a Task Plan
 ○   `ase-task-reboot`:     Reboot a Task Plan
 ○   `ase-task-preflight`:  Preflight a Task Plan
 ○   `ase-task-implement`:  Implement a Task Plan
@@ -55,6 +58,7 @@
 ○   `ase-task-delete`:     Delete a Task Plan
 
 ⎈   **OTHER SKILLS**
+○   `ase-meta-workflow`:   Generate a Workflow Skill
 ○   `ase-meta-config`:     Configuration Management
 ○   `ase-meta-compat`:     Self-Test ASE Compatibility
 

package/plugin/skills/ase-meta-brainstorm/SKILL.md

@@ -17,9 +17,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-brainstorm">
+<purpose name="ase-meta-brainstorm">
 Collaboratively Brainstorm a Topic
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-brainstorm"

package/plugin/skills/ase-meta-changelog/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-changelog">
+<purpose name="ase-meta-changelog">
 Update ChangeLog Entries
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-changelog">
     $ARGUMENTS

package/plugin/skills/ase-meta-chat/SKILL.md

@@ -16,9 +16,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-chat">
+<purpose name="ase-meta-chat">
 Query Foreign LLM for Chat
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-chat">
     $ARGUMENTS

package/plugin/skills/ase-meta-commit/SKILL.md

@@ -14,9 +14,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-commit">
+<purpose name="ase-meta-commit">
 Git Commit
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-commit">
     $ARGUMENTS

package/plugin/skills/ase-meta-config/SKILL.md

@@ -16,9 +16,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-config">
+<purpose name="ase-meta-config">
 Configuration Management
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-config"

package/plugin/skills/ase-meta-diaboli/SKILL.md

@@ -14,9 +14,9 @@ effort: xhigh
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-diaboli">
+<purpose name="ase-meta-diaboli">
 Play "Devil's Advocate"
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-diaboli"

package/plugin/skills/ase-meta-diff/SKILL.md

@@ -21,9 +21,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-diff">
+<purpose name="ase-meta-diff">
 Summarize Diff
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-diff"

package/plugin/skills/ase-meta-eli5/SKILL.md

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-eli5">
+<purpose name="ase-meta-eli5">
 Explain a Topic Like I'm 5
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-eli5"

package/plugin/skills/ase-meta-eli5/help.md

@@ -58,4 +58,4 @@ Explain a recent topic grounded in Internet/Web facts:
 
 ##  SEE ALSO
 
-[`ase-code-explain`](../ase-code-explain/help.md), [`ase-meta-search`](../ase-meta-search/help.md), [`ase-docs-distill`](../ase-docs-distill/help.md).
+[`ase-code-explain`](../ase-code-explain/help.md), [`ase-meta-search`](../ase-meta-search/help.md), [`ase-meta-quotes`](../ase-meta-quotes/help.md), [`ase-docs-distill`](../ase-docs-distill/help.md).

package/plugin/skills/ase-meta-evaluate/SKILL.md

@@ -15,9 +15,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-evaluate">
+<purpose name="ase-meta-evaluate">
 Evaluate Alternatives
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-evaluate">
     $ARGUMENTS