feat(openclaw): normalize work item references

Author: NoahCardoza

openclaw-skill/SKILL.md

@@ -8,6 +8,10 @@ metadata: { "openclaw": { "emoji": "🧵", "requires": { "anyBins": ["il", "iloo
 
 Manage isolated Git worktrees with AI-assisted development workflows.
 
+## Terminology
+
+`<workItem>` — the identifier for a work item on your configured issue tracker. Examples: `42` or `#42` (GitHub), `ENG-456` (Linear), `PROJ-789` (Jira).
+
 ## Execution Modes
 
 | Mode | Commands | Notes |
@@ -37,7 +41,7 @@ Use the **plan → review → start → spin → finish** workflow:
 
 1. **Plan:** `il plan --yolo --print --json-stream 'Description'` (background) — decomposes work into issues
 2. **Review:** Present the created epic to the user; wait for approval before continuing
-3. **Start:** `il start <issue#> --yolo --no-code --no-dev-server --no-claude --no-terminal --json` (plain exec) — creates workspace without Claude
+3. **Start:** `il start <workItem> --yolo --no-code --no-dev-server --no-claude --no-terminal --json` (plain exec) — creates workspace without Claude
 4. **Spin:** `il spin --yolo --print --json-stream` (background) — launches Claude separately
 5. **Finish:** `il finish --force --cleanup --no-browser --json-stream` (background) — merges and cleans up
 

openclaw-skill/references/core-workflow.md

@@ -156,7 +156,7 @@ Remove one or more loom workspaces without merging.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `[identifier]` | positional | — | Branch name or issue number |
+| `[identifier]` | positional | — | Branch name or work item identifier |
 | `-l, --list` | boolean | `false` | List all worktrees (informational) |
 | `-a, --all` | boolean | `false` | Remove all worktrees |
 | `-i, --issue <number>` | number | — | Cleanup by issue number |

openclaw-skill/references/development-commands.md

@@ -179,7 +179,7 @@ Start the development server for a workspace.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `[identifier]` | positional | — | Issue number, PR number, or branch name (auto-detected) |
+| `[identifier]` | positional | — | Work item identifier, PR number, or branch name (auto-detected) |
 | `--json` | boolean | `false` | Output result as JSON |
 
 ### Examples
@@ -260,7 +260,7 @@ Generate a Claude session summary for a loom.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `[identifier]` | positional | — | Issue number, PR number, branch name, or Linear/Jira ID (auto-detected) |
+| `[identifier]` | positional | — | Work item identifier (auto-detected from any tracker) |
 | `--with-comment` | boolean | `false` | Post summary as comment to issue/PR |
 | `--json` | boolean | `false` | Output result as JSON |
 

openclaw-skill/references/non-interactive-patterns.md

@@ -16,7 +16,7 @@ bash command:"il issues --json"
 bash command:"il projects --json"
 bash command:"il recap --json"
 bash command:"il --version"
-bash command:"il start <issue#> --no-claude --no-code --no-dev-server --no-terminal --json"
+bash command:"il start <workItem> --no-claude --no-code --no-dev-server --no-terminal --json"
 bash command:"il cleanup --issue 42 --force --json"
 bash command:"il build"
 bash command:"il test"
@@ -32,9 +32,9 @@ These commands spawn Claude Code sessions or run extended operations that can ta
 ```bash
 bash background:true command:"il plan --yolo --print --json-stream"
 bash background:true command:"il spin --yolo --print --json-stream"
-bash background:true command:"il start <issue#> --yolo --no-code --no-terminal --json"  # with Claude (default)
+bash background:true command:"il start <workItem> --yolo --no-code --no-terminal --json"  # with Claude (default)
 bash background:true command:"il summary --json"
-bash background:true command:"il enhance <N> --no-browser --json"
+bash background:true command:"il enhance <workItem> --no-browser --json"
 bash background:true command:"il commit --no-review --json-stream"
 bash background:true command:"il finish --force --cleanup --no-browser --json-stream"
 bash background:true command:"il rebase --force --json-stream"
@@ -119,7 +119,7 @@ Every interactive prompt in iloom and the flag(s) that bypass it:
 ### Full Autonomous Start (create workspace)
 
 ```bash
-bash command:"il start <issue> --yolo --no-code --no-claude --no-dev-server --no-terminal --json"
+bash command:"il start <workItem> --yolo --no-code --no-claude --no-dev-server --no-terminal --json"
 ```
 
 - `--yolo`: bypass all permission prompts
@@ -132,7 +132,7 @@ bash command:"il start <issue> --yolo --no-code --no-claude --no-dev-server --no
 ### Full Autonomous Start (with Claude)
 
 ```bash
-bash background:true command:"il start <issue> --yolo --no-code --no-terminal --json"
+bash background:true command:"il start <workItem> --yolo --no-code --no-terminal --json"
 ```
 
 - Same as above but launches Claude — needs `background:true`

openclaw-skill/references/planning-and-issues.md

@@ -118,7 +118,7 @@ Apply AI enhancement to an existing issue's description.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `<issueNumber>` | positional | — | Issue number or identifier (required) |
+| `<workItem>` | positional | — | Work item identifier (required) |
 | `--no-browser` | boolean | `false` | Skip browser opening prompt |
 | `--author <username>` | string | — | GitHub username to tag in questions |
 | `--json` | boolean | `false` | Output result as JSON (non-interactive) |