Teach the skill to assume WORKLANE_ACTOR and reserve --actor for another's action
This commit is contained in:
+19
-16
@@ -365,30 +365,33 @@ Read the block before picking a ticket up: it says whether somebody has already
|
||||
|
||||
## Who your entries are attributed to
|
||||
|
||||
Every comment carries an author, and by default that is the git user of the machine you
|
||||
are running on, which is the human whose checkout it is and not you. Set
|
||||
`WORKLANE_ACTOR` in your own environment and it becomes the author of every entry you
|
||||
write, so a board several agents write to says which of them said what:
|
||||
Every entry carries an author, and yours comes from `WORKLANE_ACTOR`, which your harness
|
||||
sets before you run anything. **Assume it is set for you, and never spell yourself out on
|
||||
a call** — a plain `worklane comment` is already attributed to you, which is what keeps a
|
||||
board several agents write to saying which of them said what. It is configured once,
|
||||
where your session's environment lives: `env` in `~/.claude/settings.json` for Claude
|
||||
Code, and the environment opencode is started with for opencode, since it passes its own
|
||||
environment to the tools it runs.
|
||||
|
||||
**Reach for `--actor` only when the entry is somebody else's action**: the person asked
|
||||
you to move a ticket, or to put words on the board as their comment, so name them on the
|
||||
flag — the move was theirs and the words are theirs, and an entry carrying your name
|
||||
reads later as though you decided both. Otherwise leave it off, unless your instructions
|
||||
say to use it. It is spelled the same on every command that writes an entry: `comment`,
|
||||
`mv`, `chown`, `set` and `assign`.
|
||||
|
||||
```
|
||||
WORKLANE_ACTOR=claude worklane comment 1b78a24 "The offset was never passed to the widget."
|
||||
worklane mv 1b78a24 --status done --actor "Ansho Rei"
|
||||
```
|
||||
|
||||
Set it once where your session's environment is configured, not on each call: `env` in
|
||||
`~/.claude/settings.json` for Claude Code, and the environment opencode is started with
|
||||
for opencode, since it passes its own environment to the tools it runs. `--actor`
|
||||
overrides it for one call and is spelled the same on every command that writes an entry,
|
||||
`comment`, `mv`, `chown`, `set` and `assign`. An empty value counts as unset and falls
|
||||
back to the
|
||||
git user, and with nothing at all the author is `unknown`. It is free text, checked
|
||||
against nothing: name yourself something a person reading the board will recognise.
|
||||
Under a missing or empty variable the author falls back to the git user of the machine —
|
||||
the human whose checkout it is — and with neither, `unknown`. It is free text, checked
|
||||
against nothing: whatever name you pass, make it one a person reading the board will
|
||||
recognise.
|
||||
|
||||
On `chown`, `--actor` is not the user argument: `worklane chown alice 1b78a24` makes alice
|
||||
the ticket's owner, and `--actor` says who made that change.
|
||||
|
||||
If the variable is not set and you cannot set it, pass `--actor` rather than letting the
|
||||
comment claim to be the user's.
|
||||
|
||||
## Shell completions
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user