




















@@ -42,14 +42,19 @@ view shows a plugin-unavailable state instead of local card data.
4242Each card stores:
43434444- title and notes
45-- status: `backlog`, `todo`, `running`, `review`, `blocked`, or `done`
45+- status: `triage`, `backlog`, `todo`, `scheduled`, `ready`, `running`,
46+`review`, `blocked`, or `done`
4647- priority: `low`, `normal`, `high`, or `urgent`
4748- labels
4849- optional agent id
4950- optional linked session, run, task, or source URL
5051- optional execution metadata for a Codex or Claude session started from the card
51-- compact metadata for attempts, comments, links, proof, artifacts, claims, diagnostics, notifications, templates, archive state, and stale-session detection
52-- recent card events such as created, moved, linked, claimed, heartbeat, attempt, proof, artifact, diagnostic, notification, archive, stale, or agent-updated changes
52+- compact metadata for attempts, comments, links, proof, artifacts, automation,
53+ claims, diagnostics, notifications, templates, archive state, and
54+ stale-session detection
55+- recent card events such as created, moved, linked, claimed, heartbeat,
56+ attempt, proof, artifact, diagnostic, notification, dispatch, archive, stale,
57+ or agent-updated changes
53585459Cards are stored in the plugin's Gateway state. They are local to the Gateway
5560state directory and move with the rest of that Gateway's OpenClaw state.
@@ -87,14 +92,23 @@ Workboard also exposes optional agent tools for board-aware workflows:
8792- `workboard_list` lists compact cards with claim and diagnostic state.
8893- `workboard_read` returns one card plus bounded worker context built from notes,
8994 attempts, comments, links, proof, artifacts, and active diagnostics.
90-- `workboard_claim` claims a card for the calling agent and moves backlog or todo
91- cards into `running`.
95+- `workboard_create` creates a card with optional parents, tenant, skills,
96+ workspace metadata, idempotency key, runtime limit, and retry budget.
97+- `workboard_link` links a parent card to a child card. Children stay in `todo`
98+ until every parent reaches `done`; then dispatch promotion moves them to
99+`ready`.
100+- `workboard_claim` claims a card for the calling agent and moves backlog, todo,
101+ or ready cards into `running`.
92102- `workboard_heartbeat` refreshes the claim heartbeat during longer runs.
93103- `workboard_release` releases the claim after completion, pause, or handoff and
94104 can move the card to a next status.
95-- `workboard_comment`, `workboard_proof`, and `workboard_unblock` let an agent
96- add handoff notes, attach proof or artifact references, and move blocked work
97- back to `todo`.
105+- `workboard_complete` and `workboard_block` are structured lifecycle tools for
106+ final summaries, proof, artifacts, created-card manifests, and blocker
107+ reasons.
108+- `workboard_comment`, `workboard_proof`, `workboard_unblock`, and
109+`workboard_dispatch` let an agent add handoff notes, attach proof or artifact
110+ references, move blocked work back to `todo`, and nudge dependency promotion or
111+ stale-claim cleanup.
9811299113Claimed cards reject agent-tool mutations from other agents unless the caller
100114has the claim token returned by `workboard_claim`. Dashboard operators still use
@@ -105,6 +119,12 @@ flag assigned cards that wait too long, running cards without recent heartbeat,
105119blocked cards that need attention, repeated failures, done cards without proof,
106120and running cards that only have a loose session link.
107121122+Dispatch is intentionally Gateway-local. It does not spawn arbitrary operating
123+system processes; normal OpenClaw sessions still own execution. A dispatch nudge
124+promotes dependency-ready cards, records dispatch metadata on ready cards, and
125+blocks expired claims or timed-out runs so operators can recover them from the
126+board.
127+108128## Session lifecycle sync
109129110130Cards can be linked to existing dashboard sessions or to the session created
@@ -163,8 +183,9 @@ The plugin registers Gateway RPC methods under the `workboard.*` namespace:
163183- `workboard.cards.export` requires `operator.read`
164184- `workboard.cards.diagnostics` requires `operator.read`
165185- `workboard.cards.diagnostics.refresh` requires `operator.write`
166-- create, update, move, delete, comment, link, proof, artifact, claim, heartbeat,
167- release, unblock, bulk, and archive methods require `operator.write`
186+- create, update, move, delete, comment, link, dependency link, proof, artifact,
187+ claim, heartbeat, release, complete, block, unblock, dispatch, bulk, and
188+ archive methods require `operator.write`
168189169190Browsers connected with read-only operator access can inspect the board but
170191cannot mutate cards.
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。