- name
- kickoff
- description
- Use to launch a background Claude agent in tmux (or docker/podman) to implement a feature end-to-end. Delegates worktree creation, prompt building, and session launch to `crosslink kickoff run`, then prints how to attach (`tmux attach -t <session>`) and check status (`/check`). Trigger when the user says "kick off an agent for X", "/kickoff …", or asks for a background agent / sub-agent / worker to do a feature.
# Kickoff — background agent for a feature
The user provides a feature description (e.g. "add batch retry logic") and optionally additional context. Delegate to the `crosslink kickoff run` CLI command which handles worktree creation, agent prompt generation, and tmux session launch.
## Arguments
The user may pass these flags after the feature description:
- `--verify <level>`: Controls post-implementation verification depth.
- `local` (default): Local tests + self-review checklist only.
- `ci`: Push branch, open draft PR, wait for CI to pass, fix failures.
- `thorough`: Everything in `ci` plus a structured adversarial self-review.
- `--issue <id>`: Use an existing crosslink issue instead of creating a new one.
- `--container <runtime>`: Use `docker` or `podman` instead of local tmux. Default: `none`.
- `--model <model>`: LLM model to use. Default: `opus`.
- `--timeout <duration>`: Max runtime (e.g. `1h`, `30m`). Default: `1h`.
- All other text is the feature description.
**Parsing**: Split arguments on whitespace. Extract recognized `--flag value` pairs. Everything remaining is the feature description.
## Steps
1. **Validate prerequisites**: Check that `tmux` and `claude` are available (for local mode). If `--verify ci` or `--verify thorough`, check that `gh` is available. If missing, tell the user what to install and stop.
2. **Build the crosslink kickoff command**: Map parsed arguments to CLI flags:
```bash
crosslink kickoff run "<feature description>" \
--verify <level> \
--container <runtime> \
--model <model> \
--timeout <duration>
```
Add `--issue <id>` if the user specified one. Add `--dry-run` if the user asked for a dry run.
3. **Run the command**: Execute `crosslink kickoff run` with all flags. The CLI handles:
- Creating the feature branch and worktree
- Creating or assigning the crosslink issue
- Initializing the agent identity
- Detecting project conventions
- Building the self-contained KICKOFF.md prompt
- Launching the tmux session (or container)
4. **Report**: The CLI prints the summary. Relay it to the user. Remind them to:
- Approve trust: `tmux attach -t <session-name>`
- Check status: `crosslink kickoff status <agent-id>` or invoke the `check` skill on `<session-name>`
## Constraints
- Never force-push or delete branches.
- Do not push the branch to a remote from this skill. (The child agent handles pushing when `--verify ci` or `--verify thorough`.)
- All prompt building and agent lifecycle is handled by `crosslink kickoff run`.
- If a tmux session with the same name already exists, the CLI appends a random suffix automatically.
Voir sur GitHub