wt-update
Updates an existing commitment when the user reports progress: completion, a new deadline, a stall, or abandonment. Use when the user says "I did that", "finished X", "still waiting on Y", "push that to next week", "I started it", or "forget it, I'm not doing X". Finds the matching open action, applies the change, and routes any knowledge the report carries to the knowledge base. Do NOT use to file a new commitment (that is wt-capture) or to find time for one (wt-schedule).
- License 许可
- MIT
- 所属仓库
- AlmogBaku/aos
- 最近更新
- 2026-11-15
- Stars
- ★ 5
- Forks
- 2
01 前言 Front Matter
- name
- wt-update
- metadata
- { "aos": { "origin": "work-tracker@0.1.5" } }
- description
- Updates an existing commitment when the user reports progress: completion, a new deadline, a stall, or abandonment. Use when the user says "I did that", "finished X", "still waiting on Y", "push that to next week", "I started it", or "forget it, I'm not doing X". Finds the matching open action, applies the change, and routes any knowledge the report carries to the knowledge base. Do NOT use to file a new commitment (that is wt-capture) or to find time for one (wt-schedule).
03 SKILL.md 正文
update
Three steps. The third is the one an implementation forgets, and the one that keeps the whole design honest.
1. Find what was meant
kb --base commitments find --where type=action --where status=next
The open set is small, so match by title against what the user said. Add
--where status=waiting when the report sounds like waiting ("still nothing from Robin").
Genuinely ambiguous between two actions → ask which. Guessing here writes the wrong page and the user finds out later, if ever, which is worse than one short question.
Nothing matches → this is probably a new commitment. Hand to wt-capture rather than inventing a page here.
2. Apply it
kb set for every change — it validates against the base's schema and makes its own
attributed commit:
| The user says | Apply |
|---|---|
| "I did that", "finished X" | status=done and expires=<today + 90 days> |
| "I started it" | since=<today> — nothing else |
| "still waiting on Robin" | status=waiting waiting_on=Robin since=<today> |
| "push that to next week" | the new due= or block=, and slipped +1 |
| "forget it, I'm not doing X" | status=done + a near expires — see below |
kb --base commitments set actions/write-the-cfp.md status=done expires=<DATE>
since moves on any progress report, even one that changes nothing else. That is what
keeps stall detection honest: without it the steward nags about a commitment actively being
worked on, and a nag that is wrong once gets the whole nightly report ignored.
Completion needs expires as well as status: done. expires is the only lifetime rule
kb has, so a done action without one lives forever — and a list with no exit is the graveyard
this capability exists to avoid. The user's retention window is 90 days.
Abandonment is a status, not a deletion. "Forget it" still gets done plus a short
expires: the record of having decided not to do something is worth the few weeks it costs,
and deleting on the spot means the user cannot ask why it disappeared.
3. Hand the outcome to kb
"They want a pilot in Q4" is knowledge, not a commitment. It goes to the knowledge base
as a capture, so it outlives the action when expires fires:
kb --base <the user's knowledge base> capture --text "Acme wants a pilot in Q4" --source chat
--base is not optional here, and omitting it is silent. An unqualified kb capture
resolves by walking up from the working directory, and you are working inside the commitments
base — so the knowledge lands in the base it was supposed to outlive, at exit 0, with a
cheerful confirmation naming a file in the wrong tree. Name the knowledge base explicitly
(kb-route picks it if you do not know which one); every other command in this capability
carries --base commitments, and this is the one that must not.
That lands in the knowledge base's .kb/pending/, and kb's archiver promotes it to the
project page overnight — you do not write the wiki page yourself.
Without this step the never-the-only-copy rule is aspirational, and kb prune starts
losing things: the action page said the call happened, the action page is gone, and what was
actually agreed went with it. Everything else here is bookkeeping; this is the part that
protects the user's memory.
A report that carries no knowledge needs nothing — most *"I did that"*s are exactly that. Judge whether a fact came with it, and prefer capturing over not: a redundant capture costs one queue entry, a lost one costs the thing itself.
04 同仓库更多 Skills
wt-update
Updates an existing commitment when the user reports progress: completion, a new deadline, a stall, or abandonment. Use when the user says "I did that", "finished X", "still waiting on Y", "push that to next week", "I started it", or "forget it, I'm not doing X". Finds the matching open action, applies the change, and routes any knowledge the report carries to the knowledge base. Do NOT use to file a new commitment (that is wt-capture) or to find time for one (wt-schedule).
wt-steward
Maintains an existing commitments backlog: overdue, about to expire, stalled, and repeatedly-rescheduled commitments, and someday items gone cold. Use when the nightly cron job fires or the user asks to review or tidy their backlog ('review my backlog', 'what's gone stale on my list'). Does not capture or schedule new work — that happens when the user speaks, through wt-capture and wt-schedule.
wt-schedule
Estimates a commitment, links it to its project, and blocks time for it on the user's calendar. Use when the user asks to find time for something — "when can I do this?", "find me two hours for the CFP", "block time for that tomorrow", "I want to work on it today" — and immediately after wt-capture files a commitment that needs real hours. Do NOT use for a commitment that needs only a deadline or a reminder, and do NOT use to change what the user committed to — that is wt-update.
wt-capture
Records something the user has said they must do themselves: classifies the commitment as next, waiting, someday or trivial, writes it as an action page in their commitments base, and hands off to wt-schedule when it needs real hours. Use when the user commits to work of their own — "I need to find time to…", "I have to…", "remind me to…", "help me remember…", "put that on my list", "I should … at some point". Do NOT use when the user asks the assistant to do the work ("write the CFP", "research X", "email Sam") — that is a request to act now, not a commitment to track. Do NOT use for thoughts, facts or notes carrying no commitment; those are knowledge and belong to kb-capture.
work-tracker
Answers questions about the user's own commitments by querying their commitments base, explains the four statuses (next, waiting, someday, done), routes a request to the right work-tracker skill, and states who may change what without asking. Use when the user asks what they should be working on, what is overdue, what they are waiting on, or how their task tracking works, and no narrower work-tracker skill matches. Do NOT use to file a commitment the user just made (that is wt-capture), to find time for one (wt-schedule), or to report progress on one (wt-update).
kb
Explains how the user's knowledge bases are laid out and which kb skill handles a given job — the tree, the one queue, expiry, links, base health, maintenance. Use when the user asks how their knowledge base works, what state a base is in, why something was or was not kept, or wants base maintenance run, and no narrower kb skill matches. Do NOT use to file something the user just said (that is kb-capture), to answer a question from stored knowledge (that is kb-recall), or to pick a destination base for a write already in hand (that is kb-route).