docs: update docs for directory structure preservation (v1.0.2)

Update SKILL.md and workflow_examples.md to reflect the new behavior
of recover_content.py which now preserves original directory structure:

- SKILL.md: Add 'preserving the original directory structure' note
- SKILL.md: Update verification examples to use find command and
  show subdirectory paths (e.g., ./recovered_content/src/components/)
- workflow_examples.md: Update diff example to account for nested paths

Version bump: 1.0.1 → 1.0.2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
daymade
2026-04-05 13:47:47 +08:00
parent 2833aaec42
commit ccc10f3417
3 changed files with 10 additions and 9 deletions

View File

@@ -378,7 +378,7 @@
"description": "Find and recover content from Claude Code session history files. Use when searching for deleted files, tracking changes across sessions, analyzing conversation history, or recovering code/documents from previous Claude interactions. Triggers include mentions of session history, recover deleted, find in history, previous conversation, or .claude/projects", "description": "Find and recover content from Claude Code session history files. Use when searching for deleted files, tracking changes across sessions, analyzing conversation history, or recovering code/documents from previous Claude interactions. Triggers include mentions of session history, recover deleted, find in history, previous conversation, or .claude/projects",
"source": "./", "source": "./",
"strict": false, "strict": false,
"version": "1.0.1", "version": "1.0.2",
"category": "developer-tools", "category": "developer-tools",
"keywords": [ "keywords": [
"session-history", "session-history",

View File

@@ -58,7 +58,7 @@ Extract files from session history:
python3 scripts/recover_content.py /path/to/session.jsonl python3 scripts/recover_content.py /path/to/session.jsonl
``` ```
Extracts all Write tool calls and saves files to `./recovered_content/`. Extracts all Write tool calls and saves files to `./recovered_content/`, preserving the original directory structure.
**Filtering by keywords**: **Filtering by keywords**:
@@ -125,14 +125,14 @@ python3 scripts/recover_content.py session.jsonl -o ./feature_xy_history/
After recovery, always verify content: After recovery, always verify content:
```bash ```bash
# Check file list # Check directory structure (files preserved in subdirectories)
ls -lh ./recovered_content/ find ./recovered_content/ -type f
# Read recovery report # Read recovery report (shows full output paths)
cat ./recovered_content/recovery_report.txt cat ./recovered_content/recovery_report.txt
# Spot-check content # Spot-check content (use actual path from report)
head -20 ./recovered_content/ImportantFile.jsx head -20 ./recovered_content/src/components/ImportantFile.jsx
``` ```
## Limitations ## Limitations

View File

@@ -40,8 +40,9 @@ python3 scripts/recover_content.py session1.jsonl -k componentName -o ./v1/
python3 scripts/recover_content.py session2.jsonl -k componentName -o ./v2/ python3 scripts/recover_content.py session2.jsonl -k componentName -o ./v2/
python3 scripts/recover_content.py session3.jsonl -k componentName -o ./v3/ python3 scripts/recover_content.py session3.jsonl -k componentName -o ./v3/
# 4. Compare versions # 4. Compare versions (files retain original directory structure)
diff ./v1/componentName.jsx ./v2/componentName.jsx # Use find to locate the file in subdirectories, or reference the recovery_report.txt
find ./v1/ -name "componentName.jsx" -exec diff {} ./v2/{} \;
``` ```
## Find Session with Specific Implementation ## Find Session with Specific Implementation