Recall
Contract
| Field |
Bound contract |
| Trigger |
Recover prior work and current status before resuming. |
| Authority |
Read-only. No file, VCS, credential, paid, published, deployed, or remote mutation. |
| Side effect |
Chat-output only. No file, credential, paid, published, deployed, or remote mutation. |
| Done |
Status-tagged capsule and one concrete next move. |
Refusals
- Fabricating state: rejected. If no session file is found, return
session-not-found. Do not invent artifacts or actions.
- Suppressing divergences: rejected. Verified records with divergence flags are returned; divergences are not hidden to satisfy the done predicate.
- Source or remote-system changes: rejected. This skill is read-only throughout.
Inputs
- Session identifier (required): the active session ID or session directory path to recover.
- Current working directory (required): the directory the agent was operating in when the session ended.
- Optional scope hint: a specific file, module, or task tag to narrow recovery. Omit to recover the full capsule.
Procedure
- Identify the session source. Locate the session state file or transcript corresponding to the supplied session identifier. If no session file is found, return
session-not-found. Done when: the session file is located or session-not-found is returned.
- Extract the transcript. Parse the session transcript. If parsing fails, return
transcript-parse-failure. Done when: the transcript is parsed or transcript-parse-failure is returned.
- Mine the transcript for work state. Collect all completed actions, emitted artifacts, tool results, and navigation events. Extract each as a discrete record with its outcome. Done when: every work record is extracted with its outcome.
- Verify against live repository state. For each file, artifact, and VCS-tracked target mentioned in the transcript, read the live filesystem and confirm the record matches current state. Flag each mismatch as a
divergence. Done when: every record is verified or flagged as divergent.
- Tag the capsule. Assign each recovered record one of:
completed, in-progress, blocked, or diverged. Done when: every record has a status tag.
- Identify the concrete next move. From the in-progress and blocked records, select the highest-priority actionable item that is not blocked by an unresolved divergence. State it as one concrete next move. Done when: one concrete next move is stated.
- Emit the capsule. Return a structured capsule containing all tagged records, the concrete next move, and a summary of divergences. Done when: the capsule is returned.
Failure and recovery
session-not-found: return with the identifier. Do not fabricate state.transcript-parse-failure: return with the parse error. Do not continue with partial data.no-recoverable-state: return when the transcript contains no identifiable work records. Do not invent artifacts or actions.
If some records verify and others diverge, return the verified records with divergence flags. This skill performs no mutations; no rollback is required.
Output
A structured capsule with session_id, records (each with action, outcome, status, divergence_note), next_move, and divergences, ordered as listed.
1---2name: recall-23description: Use when asked to recover prior work and current status before resuming. Returns a status-tagged capsule and one concrete next move. Not for handoff snapshots — use handoff. Not for tasks that require source or remote-system changes.4---5
6# Recall
7
8## Contract
9
10| Field | Bound contract |
11|---|---|
12| Trigger | Recover prior work and current status before resuming. |
13| Authority | Read-only. No file, VCS, credential, paid, published, deployed, or remote mutation. |
14| Side effect | Chat-output only. No file, credential, paid, published, deployed, or remote mutation. |
15| Done | Status-tagged capsule and one concrete next move. |
16
17## Refusals
18
19- Fabricating state: rejected. If no session file is found, return `session-not-found`. Do not invent artifacts or actions.
20- Suppressing divergences: rejected. Verified records with divergence flags are returned; divergences are not hidden to satisfy the done predicate.
21- Source or remote-system changes: rejected. This skill is read-only throughout.
22
23## Inputs
24
25- Session identifier (required): the active session ID or session directory path to recover.
26- Current working directory (required): the directory the agent was operating in when the session ended.
27- Optional scope hint: a specific file, module, or task tag to narrow recovery. Omit to recover the full capsule.
28
29## Procedure
30
311. Identify the session source. Locate the session state file or transcript corresponding to the supplied session identifier. If no session file is found, return `session-not-found`. **Done when**: the session file is located or `session-not-found` is returned.
322. Extract the transcript. Parse the session transcript. If parsing fails, return `transcript-parse-failure`. **Done when**: the transcript is parsed or `transcript-parse-failure` is returned.
333. Mine the transcript for work state. Collect all completed actions, emitted artifacts, tool results, and navigation events. Extract each as a discrete record with its outcome. **Done when**: every work record is extracted with its outcome.
344. Verify against live repository state. For each file, artifact, and VCS-tracked target mentioned in the transcript, read the live filesystem and confirm the record matches current state. Flag each mismatch as a `divergence`. **Done when**: every record is verified or flagged as divergent.
355. Tag the capsule. Assign each recovered record one of: `completed`, `in-progress`, `blocked`, or `diverged`. **Done when**: every record has a status tag.
366. Identify the concrete next move. From the in-progress and blocked records, select the highest-priority actionable item that is not blocked by an unresolved divergence. State it as one concrete next move. **Done when**: one concrete next move is stated.
377. Emit the capsule. Return a structured capsule containing all tagged records, the concrete next move, and a summary of divergences. **Done when**: the capsule is returned.
38
39## Failure and recovery
40
41- `session-not-found`: return with the identifier. Do not fabricate state.
42- `transcript-parse-failure`: return with the parse error. Do not continue with partial data.
43- `no-recoverable-state`: return when the transcript contains no identifiable work records. Do not invent artifacts or actions.
44
45If some records verify and others diverge, return the verified records with divergence flags. This skill performs no mutations; no rollback is required.
46
47## Output
48
49A structured capsule with `session_id`, `records` (each with action, outcome, status, divergence_note), `next_move`, and `divergences`, ordered as listed.
majiayu000