git:20260803.8598a3b to git:20260806.59c9744

---

name: ase-task-list

argument-hint: "[--help|-h] [--verbose|-v] [--include|-i=<state>[,...]] [--exclude|-e=<state>[,...]]"

description: >

List all available task ids.

Use when user wants to see all tasks.

user-invocable: true

disable-model-invocation: false

effort: high

---

@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md

@${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md

@${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md

<purpose name="ase-task-list">

List Task Plans

</purpose>

<expand name="getopt"

arg1="ase-task-list"

arg2="--verbose|-v --include|-i=none --exclude|-e=COMPLETED,CANCELLED">

$ARGUMENTS

</expand>

<objective>

*List* all available *task plans* of the current project.

</objective>

Procedure

---------

1. Determine the *effective state set* <states/>, i.e., the lifecycle

states a task plan has to be in to be listed 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 eight

`Status:` values `DRAFTED`, `REJECTED`, `APPROVED`, `DEFERRED`,

`STARTED`, `BLOCKED`, `COMPLETED`, or `CANCELLED`, only output the

following <template/> and then *STOP* processing the entire current

skill:

<template>

⧉ **ASE**: ✪ skill: **ase-task-list**, ▶ ERROR: invalid state: **<token/>**

</template>

Otherwise set <states/> to *all* eight states if both lists are

empty, to the *include* list if only it is non-empty, to all eight

*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 <states/> is *empty*, only output the following

<template/> and then *STOP* processing the entire current skill:

<template>

⧉ **ASE**: ✪ skill: **ase-task-list**, ▶ ERROR: options `--include` and `--exclude` cancel out to an empty state set

</template>

2. Call the `ase_task_list(verbose: <getopt-option-verbose/>)` tool from

the `ase` MCP server. The result is a structured object with a

`tasks` array where each entry has an `id` and a `status` field, and

-- if <getopt-option-verbose/> is `true` -- additionally an `mtime`

field (formatted as `YYYY-MM-DD HH:MM`). *Drop* from the `tasks`

array every entry whose `status` is *not* contained in <states/>. Do

not output anything.

3. If the `tasks` array is empty, output the following <template/>:

<template>

⧉ **ASE**: ◉ tasks: *(none)*

</template>

Else, dispatch on <getopt-option-verbose/>:

- If <getopt-option-verbose/> is `true`, output the list of tasks

with the following <template/>, where each <id/>, <status/>, and

<mtime/> correspond to an entry in the task list:

<template>

⧉ **ASE**: ◉ tasks:

| *Task Id* | *Status* | *Last Modified* |

|-----------|-------------|--------------------|

| **<id/>** | `<status/>` | `<mtime/>` |

| [...] | [...] | [...] |

</template>

- If <getopt-option-verbose/> is `false`, output the list of tasks

with the following <template/>, where each <id/> corresponds to

an entry in the task list:

<template>

⧉ **ASE**: ◉ tasks:

| *Task Id* |

|-----------|

| **<id/>** |

| [...] |

</template>

4. Finally, give the closing hints by expanding the following (which,

depending on the configured <ase-guidance-level/>, may each expand

into nothing and hence emit no output at all):

<if condition="the `tasks` array is NOT empty">

<ase-tpl-hint level="normal">

Use `/ase-task-id <id>` to switch to one of the listed tasks and `/ase-task-view` to inspect its plan.

</ase-tpl-hint>

</if>

<elseif condition="entries were dropped by the state filtering of step 2">

<ase-tpl-hint level="normal">

All task plans were filtered out by the effective state set -- use `/ase-task-list --exclude none` to list them regardless of their status.

</ase-tpl-hint>

</elseif>

<else>

<ase-tpl-hint level="normal">

No task plan exists yet -- use `/ase-task-edit` to create one through a conversational loop.

</ase-tpl-hint>

</else>

<if condition="<getopt-option-verbose/> is not equal `true`">

<ase-tpl-hint level="verbose">

Use `/ase-task-list --verbose` to additionally show the status and the last-modified timestamp of each task plan.

</ase-tpl-hint>

</if>

<ase-tpl-hint level="verbose">

Use `/ase-task-list --include`/`--exclude` to narrow the listing to certain lifecycle states, e.g. `--include STARTED,BLOCKED`.

</ase-tpl-hint>