Skip to content

Commit 1a567b3

Browse files
committed
docs: clarify context recovery skill usage
1 parent 1360b00 commit 1a567b3

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

  • skills/codexmate-project-context-recovery

skills/codexmate-project-context-recovery/SKILL.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Old sessions are historical evidence. Mutable facts such as PR state, CI, releas
1313

1414
## Quick Start
1515

16-
Generate a context brief first:
16+
Generate a context brief first. Resolve `scripts/search_sessions.py` relative to this skill directory; after npm installation the full package path is `node_modules/codexmate/skills/codexmate-project-context-recovery/scripts/search_sessions.py`.
1717

1818
```bash
1919
python3 scripts/search_sessions.py "SakuraByteCore/codexmate feat/task-orchestration-tab" --mode brief --source all --path-filter codexmate --match all --format text --limit 8
@@ -30,17 +30,17 @@ python3 scripts/search_sessions.py "exact error text" --mode search --source all
3030
1. **Confirm the object**: repo/project, PR/issue number, branch, file path, command, exact error text, person, or date range. If multiple projects match, state the chosen object before searching.
3131
2. **Prefer hard identifiers**: exact `owner/repo`, short repo name, PR/issue number with repo filter, branch, file path, commit hash, exact error, then user wording.
3232
3. **Generate a brief**: use `--mode brief`; add `--path-filter` for project/worktree isolation; use `--match all` when the query has strong identifiers.
33-
4. **Check confidence**: `high` means multiple hard signals appeared; `medium/weak` means re-query with stronger identifiers before relying on it.
33+
4. **Check confidence**: `high` means multiple hard signals appeared; `medium/weak` means re-query with stronger identifiers before relying on it; `none` means no hits were found.
3434
5. **Use the brief as a handoff**: extract timeline, decisions, validations, risks, files, commands, commits, and top evidence sessions.
3535
6. **Live-check mutable facts**: before commenting, merging, releasing, or claiming current status, check GitHub/current files directly.
3636

3737
## What Good Output Looks Like
3838

39-
- **当前对象:** repo / PR / branch / file / error
39+
- **Target Object:** repo / PR / branch / file / error
4040
- **Context Brief:** confidence, top sources, timeline, repos/branches/PRs/files
41-
- **历史证据:** session source/id/path + snippets
42-
- **接手简报:** decisions, validations, risks, commands, commits
43-
- **实时核查:** PR/check/review/release/current-file facts that still need live verification
41+
- **Historical Evidence:** session source/id/path + snippets
42+
- **Handoff Summary:** decisions, validations, risks, commands, commits
43+
- **Live Verification:** PR/check/review/release/current-file facts that still need live verification
4444

4545
## Optional codexmate MCP Path
4646

0 commit comments

Comments
 (0)