AGENT SKILL

revealui-pickup

Consume the rolling CURRENT-HANDOFF and continue agent-doable work. Use when the user runs /pickup, asks to continue from checkpoint, pick up the last session, or resume fleet handoff work in a new session. Not /next (TRACKER free surfaces). Not /resume (vendor transcript). Not /recover (crash inventory).

License 许可
MIT
最近更新
2026-11-11
Stars
★ 2
Forks
0

01 前言 Front Matter

name
revealui-pickup
license
MIT
metadata
{ "author": "RevealUI Studio", "related": [ "revealui-checkpoint", "revealui-tracker", "revealui-recover", "revealui-cleanup", "revealui-rollup" ], "version": "0.2.0", "website": "https://revealui.com" }
description
Consume the rolling CURRENT-HANDOFF and continue agent-doable work. Use when the user runs /pickup, asks to continue from checkpoint, pick up the last session, or resume fleet handoff work in a new session. Not /next (TRACKER free surfaces). Not /resume (vendor transcript). Not /recover (crash inventory).
allowed-tools
Bash, Read, Grep

03 SKILL.md 正文

Pickup (/pickup) — consume CURRENT-HANDOFF

Clean continue after /checkpoint. Read the rolling handoff, re-verify live git/gh, then do remaining agent work. Do not invent a second board.

/next stays TRACKER free surfaces. /recover stays crash diagnostics. Grok /resume and grok --continue reload a transcript, not this file.

Do not run this on SessionStart. Opening a session is not consent to continue last night's PR.

Load helpers:

. "$REVEALFLEET_ROOT/revskills/scripts/lib/session-state.sh"

Step 1 — Render + read

CURRENT_HANDOFF="$(cd "$JV_REPO" && node scripts/handoff-render.js)"

Stdout is the path to read. On the shared primary checkout the renderer writes gitignored docs/handoffs/.CURRENT-HANDOFF.local.md so .jv stays clean. In a worktree it writes CURRENT-HANDOFF.md in that tree. Do not commit the render. Then read $CURRENT_HANDOFF sections Launch, Ordered next actions, Owner-gated, In-flight, and the newest rolling fragment under docs/handoffs/rolling/.

If the file is missing: say so, run Step 6 (TRACKER print), stop. If Launch is missing: fail closed — name that the fragment predates ADR 2026-08-26-session-launch-record. Do not guess a product.

Step 2 — Re-verify (mandatory)

Fragments go stale the moment the owner merges. Do not trust prose. Classification is handoff-status.js, the same script the "what now?" status line uses. Do not re-implement gh pr view in the session.

node "$JV_REPO/scripts/handoff-status.js"

done is merged or closed. owner-gated is an open pull request whose remaining line is an owner merge, or a pull request named only under Owner-gated. agent-doable is an open pull request whose ordered-next line still says to clear, fix, push, or re-run CI.

Also confirm named worktrees/branches still exist:

cd "$REVEALFLEET_ROOT/revealui" && git worktree list

Step 3 — Classify

Class Meaning This session
done Live git/gh matches the tail (merged, deleted, already applied) Note and skip
owner-gated Merge, vault, prod, promote, machine UAC, stranded checkout List the one-line owner command. Do not do it
agent-doable Spec, PR, tests, docs, conflict fix, follow-up an agent can do Continue it

Print a short live board. Stale fragment lines stay in the file; live state wins.

Step 4 — Continue

First action is CURRENT-HANDOFF ## Launch row 1 (exact rfg/rfc command, including --worktree=). That is Ordered next item 1. Then:

  1. If any agent-doable remains after Launch: do it this session. Worktree from origin/test in the product named by Launch. Do not dirty-switch a shared checkout.
  2. Else if only owner-gated remains: list the script's gh pr merge lines, then run Step 6. Do not merge. When the owner says "merged", re-run handoff-status.js and continue Step 4.
  3. Else (checkpoint exhausted): Step 6.

Never merge, force-push, add gate labels, or edit a stranded .jv checkout (docs/gap-381-yml-with-render or any chore/checkpoint-* main HEAD).

Step 5 — Report

=== PICKUP ===
Handoff:     $CURRENT_HANDOFF
Live:        <one line: what is still true after gh>
Doing:       <agent-doable item 1 | owner-gated wait | tracker fallthrough>
Owner-gated: <commands or none>

Then execute the Doing line. On owner-gated, print the merge lines and Step 6. Do not merge.

Step 6 — Board under the handoff

Same entry as /next. sync refreshes the board and the goals overlay. tracker.js next does not.

node "$JV_REPO/scripts/tracker.js" sync

Print free surfaces under the handoff board. Do not auto-claim a gap. Wait for the owner to pick.

Do not

  • Do not steal /next or print TRACKER before finishing Steps 1–4.
  • Do not paste a next-agent prompt back at the owner; this skill is the consume path.
  • Do not start /recover unless git is corrupt or the owner asked.
  • Do not auto-run on SessionStart.
  • Do not guess a product when Launch is missing.
  • Do not rewrite tracked CURRENT-HANDOFF.md on the shared primary .jv.
  • Residue after consume is /cleanup (report) or /cleanup --fix (gated). Stale MASTER_HANDOFF is /rollup. Do not invent a second sweep.

04 同仓库更多 Skills

revealui-studio
revealui-studio/revskills

good-skill

A minimal valid skill fixture used to prove the skills-lint and plugin-lint validators accept well formed input. Covers frontmatter shape only.

Skill与智能体开发
★ 2
revealui-studio
revealui-studio/revskills

bad-skill-missing-field

暂无简介

Skill与智能体开发
★ 2
revealui-studio
revealui-studio/revskills

bad-skill-awk

Fixture skill whose fenced shell block violates lint-skill.awk. skills-lint must reject it.

Skill与智能体开发
★ 2
revealui-studio
revealui-studio/revskills

yjs-collaboration

Yjs CRDT collaboration patterns for real-time and offline-first editing. Use when building collaborative documents, shared scratchpads, or multi-user editing. Covers Y.Doc, Y.Map, Y.Array, Y.Text, state encoding, structured patches, server-side document manipulation, and conflict-free merge semantics.

后端与接口
★ 2
revealui-studio
revealui-studio/revskills

vitest-testing

Vitest testing patterns for production TypeScript projects. Use when writing tests, fixing test failures, configuring coverage, mocking modules, debugging flaky tests, or setting up Vitest in a monorepo. Covers Vitest 3+, vi.mock, vi.fn, React Testing Library, PGlite in-memory PostgreSQL, pool forks, maxWorkers, and hookTimeout.

内容创作者测试与质量写作与文案
★ 2
revealui-studio
revealui-studio/revskills

tailwind-v4

Tailwind CSS v4 patterns, CSS-first configuration, and v3 migration guide. Use when writing styles, configuring @theme variables, creating components with CVA, migrating from tailwind.config.js, or using container queries, dark mode, and new v4 utility syntax. Covers @import tailwindcss, custom properties, oklch colors, and clsx.

★ 2