joplin-llm-wiki: Skill for Cursor

Update an existing Spectra change — from a plan file or conversation context.

Plan file support is available when the tool has a plan directory (.cursor/plans/). Otherwise, use conversation context to update artifacts.

Prerequisites: This skill requires the spectra CLI. If any spectra command fails with "command not found" or similar, report the error and STOP.

Input: Optionally specify a plan file path or name.

• /spectra:ingest .cursor/plans/agile-discovering-rocket.md
• /spectra:ingest agile-discovering-rocket
• /spectra:ingest (use conversation context or auto-detect plan file)

Steps

1. Locate the requirement source

   a. Argument provided → treat as plan file reference (prepend .cursor/plans/ and append .md if needed)

   • If the file exists → use it as the plan file source, proceed to Step 2
   • If the file does NOT exist → report the error and stop

   b. No argument, plan file detectable:

   • Check conversation context for plan file path (plan mode system messages include the path like .cursor/plans/<name>.md)
   • If found and the file exists → use the AskUserQuestion tool to ask:
     • Option 1: Use the plan file
     • Option 2: Use conversation context
   • If the user picks plan file → proceed to Step 2
   • If the user picks conversation context → skip Step 2, go to Step 3

   c. No argument, no plan file detectable:

   • Check .cursor/plans/ for recent files
   • If recent files exist → list 5 most recent with the AskUserQuestion tool, include "Use conversation context" as an additional option
   • If the user picks a file → proceed to Step 2
   • If the user picks conversation context → skip Step 2, go to Step 3

   d. Conversation context fallback (no plan files found at all):

   • Use conversation context to update artifacts
   • If conversation context is insufficient, use the AskUserQuestion tool to get more details
   • Warn: "No plan file found. Using conversation context."

2. Parse the plan structure (skip if using conversation context)

   Claude Code plan files typically contain:

   • Title (# ...) — the high-level goal
   • Context section — background, motivation, current state
   • Stages/Steps — numbered implementation stages with goals and file lists
   • Files involved — list of files to modify/create
   • Verification section — how to test the changes

   Extract:

   • plan_title: from the H1 heading
   • plan_context: from the Context section
   • plan_stages: each numbered stage with its goal and file list
   • plan_files: all file paths mentioned
   • plan_verification: verification steps

3. Check for active changes (REQUIRED — ingest only updates existing changes)

   spectra list --json
   

   Also check for parked changes:

   spectra list --parked --json
   

   Parse both JSON outputs to get the full list of changes (active + parked). Parked changes should be annotated with "(parked)" in any selection list.

   • If one change exists (active or parked) → use the AskUserQuestion tool to confirm updating it
   • If multiple changes exist → use the AskUserQuestion tool to let user pick which one to update
   • If no changes at all (neither active nor parked) → tell the user: "No active change found. Use /spectra:propose first to create one." and stop

4. Select the change

   After selecting the change, check if it is parked:

   spectra list --parked --json
   

   If the selected change appears in the parked array:

   • Inform the user that this change is currently parked（暫存）
   • Use AskUserQuestion tool to ask: continue (unpark) or cancel
   • If continue: run spectra unpark "<name>" then proceed
   • If cancel: stop the workflow

   If there is no AskUserQuestion tool available (non-Claude-Code environment): Inform the user that this change is currently parked（暫存）and ask via plain text whether to unpark and continue, or cancel. Wait for the user's response. If the user confirms, run spectra unpark "<name>" then proceed.