@xevy/skills 0.1.22 → 0.1.24
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.
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "xevy",
|
|
3
3
|
"displayName": "Xevy",
|
|
4
4
|
"description": "Native /xevy:* SDLC workflow commands driven through the Xevy MCP server. Cloud (server Web Agent) by default; '-here' variants run locally in this Claude Code session. Claude reviews and corrects the result after every action.",
|
|
5
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.24",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Xevy"
|
|
8
8
|
},
|
package/package.json
CHANGED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: clean-worktree
|
|
3
|
+
description: Remove a completed task's local git worktree safely after verifying the Xevy task is done. Never deletes branches or uncommitted work.
|
|
4
|
+
argument-hint: "[task]"
|
|
5
|
+
disable-model-invocation: true
|
|
6
|
+
allowed-tools: "Read Bash mcp__xevy__find_task"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Clean a completed task worktree
|
|
10
|
+
|
|
11
|
+
1. Resolve `$ARGUMENTS` or the session task with `find_task`. Require task status `done`; otherwise stop.
|
|
12
|
+
2. Locate the matching worktree with `git worktree list --porcelain`.
|
|
13
|
+
3. In that worktree, require a clean `git status --short`. If changes exist, stop and report them.
|
|
14
|
+
4. Return to the main worktree and run `git worktree remove <exact-path>` without `--force`.
|
|
15
|
+
5. Run `git worktree prune`, verify the path is gone, and report it. Do not delete local or remote branches.
|
|
@@ -3,7 +3,7 @@ name: execute-here
|
|
|
3
3
|
description: Execute a task locally in the current coding-agent session — worktree, implement against the plan, run tests, commit, push, open a PR, deploy a preview, then review/correct. Cloud equivalent is the execute skill.
|
|
4
4
|
argument-hint: "[task]"
|
|
5
5
|
disable-model-invocation: true
|
|
6
|
-
allowed-tools: "Read Grep Edit Write Bash Agent mcp__xevy__find_task mcp__xevy__update_task mcp__xevy__update_task_status mcp__xevy__list_specs mcp__xevy__list_subtasks mcp__xevy__update_subtask mcp__xevy__list_sprints mcp__xevy__assign_task_to_sprint mcp__xevy__deploy_preview mcp__xevy__get_deploy_status mcp__xevy__list_task_decisions mcp__xevy__create_decision mcp__xevy__answer_decision"
|
|
6
|
+
allowed-tools: "Read Grep Edit Write Bash Agent mcp__xevy__find_task mcp__xevy__update_task mcp__xevy__update_task_status mcp__xevy__list_specs mcp__xevy__list_subtasks mcp__xevy__update_subtask mcp__xevy__list_sprints mcp__xevy__assign_task_to_sprint mcp__xevy__deploy_preview mcp__xevy__get_deploy_status mcp__xevy__list_task_decisions mcp__xevy__create_decision mcp__xevy__answer_decision set_session_task_lock"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# /xevy:execute-here — implement locally (then review + deploy)
|
|
@@ -18,6 +18,7 @@ You are the engine: implement the task in this session, following the Xevy workt
|
|
|
18
18
|
## 2. Worktree protocol
|
|
19
19
|
- Record the current branch + dir. Derive a canonical branch `xevy/<TASK-ID>-<slug>` (task id = task code, or first 8 chars of task UUID; reuse if one already exists for this task — never create a second branch per task).
|
|
20
20
|
- Create/attach a git worktree in a sibling dir and `cd` into it; if resuming, first merge the latest source branch (e.g. `git merge origin/main`). Do ALL work in the worktree.
|
|
21
|
+
- In Pi, call `set_session_task_lock(taskCode, taskId, taskTitle, worktreePath, branch)` immediately after attaching the worktree, using its absolute `git rev-parse --show-toplevel` path. If that tool is unavailable, continue—the worktree rules still apply.
|
|
21
22
|
- NEVER commit/push on a protected branch (master/main/develop/staging) — only on `xevy/*` task branches.
|
|
22
23
|
|
|
23
24
|
## 3. Implement
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mark-ready
|
|
3
|
-
description:
|
|
3
|
+
description: Submit a prepared draft to refinement — answer open decisions first, then move draft → ready. Ready hands the task to the configured Refine owner and may start AI Analyze/Plan.
|
|
4
4
|
argument-hint: "[task]"
|
|
5
5
|
disable-model-invocation: true
|
|
6
6
|
allowed-tools: "Read Bash mcp__xevy__find_task mcp__xevy__list_task_decisions mcp__xevy__answer_decision mcp__xevy__update_task_status"
|
|
@@ -8,13 +8,13 @@ allowed-tools: "Read Bash mcp__xevy__find_task mcp__xevy__list_task_decisions mc
|
|
|
8
8
|
|
|
9
9
|
# /xevy:mark-ready — answer open questions, then mark the task ready
|
|
10
10
|
|
|
11
|
-
This is the **human gate**
|
|
11
|
+
This is the **human submission gate** from `draft` → `ready`. Draft is preparation-only. Ready hands the task to the configured Refine owner; when that owner is AI, server automation may start Analyze and Plan after the status change.
|
|
12
12
|
|
|
13
13
|
## 1. Resolve the task
|
|
14
14
|
Resolve from `$ARGUMENTS` (`mcp__xevy__find_task` by code) or the in-context task. If ambiguous, ask which task — never guess.
|
|
15
15
|
|
|
16
16
|
## 2. Check the current status
|
|
17
|
-
Read the resolved task's status. `mark-ready` only promotes a task that is in **`draft`**. If it is already `ready` or further along (`in_progress` / `for_review` / `for_qa` / `done`), STOP and report the current status — do **NOT** move it backwards. Continue only when the status is `draft`.
|
|
17
|
+
Read the resolved task's status. `mark-ready` only promotes a task that is in **`draft`**. If it is already `ready` or further along (`planned` / `in_progress` / `for_review` / `for_qa` / `done`), STOP and report the current status — do **NOT** move it backwards. Continue only when the status is `draft`.
|
|
18
18
|
|
|
19
19
|
## 3. Answer open questions (MANDATORY gate)
|
|
20
20
|
- Call `mcp__xevy__list_task_decisions` for the task.
|
|
@@ -23,4 +23,4 @@ When the host supports subagents, dispatch a **plan-reviewer** to cross-check ev
|
|
|
23
23
|
When planning surfaces a genuine open question a human must resolve, record it with `mcp__xevy__create_decision` (preset choices + explanation) rather than guessing — it gates execution until answered.
|
|
24
24
|
|
|
25
25
|
## 4. Review & correct (MANDATORY)
|
|
26
|
-
Confirm the final plan is complete and feasible against the actual code; fix any remaining gap before finishing. Post-check: call `mcp__xevy__list_task_decisions` — if any decision is still open, surface it.
|
|
26
|
+
Confirm the final plan is complete and feasible against the actual code; fix any remaining gap before finishing. Post-check: call `mcp__xevy__list_task_decisions` — if any decision is still open, surface it. Do not change task status as a side effect of local planning. Draft is preparation-only; the user explicitly submits it to Ready. When planning is performed as the configured Refine work for a Ready task, completion moves it to Planned through the normal server-owned Process Owner flow. Do not start execution as part of local planning. Report a PASS/PARTIAL verdict, the matrix summary, any open decisions, the resulting status, and the task URL.
|
|
@@ -3,7 +3,7 @@ name: xevy-setup
|
|
|
3
3
|
description: Bootstrap Xevy for this repository — verify the MCP connection, pick a workspace/project (create one if the workspace is empty), link this repo, write .xevy/project.json, set Dockerfile-first deploy defaults, and sync any missing .env keys. Run once per repo.
|
|
4
4
|
argument-hint: "[workspace/project]"
|
|
5
5
|
disable-model-invocation: true
|
|
6
|
-
allowed-tools: "Read Write Edit Bash mcp__xevy__get_current_user mcp__xevy__list_workspaces mcp__xevy__list_projects mcp__xevy__create_project mcp__xevy__get_project_workbreakdown mcp__xevy__update_project_preview_settings"
|
|
6
|
+
allowed-tools: "Read Write Edit Bash mcp__xevy__get_current_user mcp__xevy__list_workspaces mcp__xevy__list_projects mcp__xevy__create_project mcp__xevy__get_project_workbreakdown mcp__xevy__create_category mcp__xevy__create_epic mcp__xevy__update_project_preview_settings"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# /xevy:xevy-setup — connect this repo to Xevy
|
|
@@ -49,8 +49,8 @@ The Xevy MCP server authenticates via **OAuth** when configured (run `npx @xevy/
|
|
|
49
49
|
- NEVER `cat`/read/print `.env` or any env values yourself. The helper adds only keys not already configured and never overwrites existing values. If there is no `.env`, skip this step.
|
|
50
50
|
- Auth note: the env-sync and repo-link helpers call the REST API (not MCP) and read an API key from `~/.config/xevy/credentials` (or `XEVY_API_KEY`). MCP itself uses OAuth; these two local helpers need a REST key. If none is present, tell the user to create one at Xevy → Settings → API keys, then re-run just these steps.
|
|
51
51
|
|
|
52
|
-
## 6. Bootstrap structure
|
|
53
|
-
-
|
|
52
|
+
## 6. Bootstrap structure
|
|
53
|
+
- Read `get_project_workbreakdown`. Only when the project has no categories, create 3–6 user/product-area categories (never technical-layer categories such as Frontend or API) and 1–3 starter epics per category for already-present capabilities. If categories exist, skip this step. Never create tasks.
|
|
54
54
|
|
|
55
55
|
## 7. Report
|
|
56
56
|
Summarise: workspace/project, repo link, deploy build pack + ports, count of env keys added (names only), and the next Xevy skills they can run (`analyze`, `execute`, `deploy`; slash-command names may be available in some clients). Do not print secrets.
|