54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# Skill Maintenance (Critical)
|
|
|
|
This skill is only trustworthy if it is refreshed immediately after behavior changes.
|
|
|
|
## Mandatory Refresh Triggers
|
|
|
|
Run this maintenance workflow whenever any of these change:
|
|
|
|
- `linux-game-manager.sh`
|
|
- Anything in `.install/`
|
|
- Anything in `.launch/`
|
|
- Anything in `.update/`
|
|
- Anything in `speech/`
|
|
- `README.md`
|
|
- Any game lifecycle contract (install path usage, symlink behavior, update function contracts, CLI flags)
|
|
|
|
## Refresh Workflow
|
|
|
|
1. Run catalog audit and capture output:
|
|
|
|
```bash
|
|
python3 .codex/skills/linux-game-manager-dev/scripts/audit_game_catalog.py
|
|
```
|
|
|
|
2. Re-check core flow definitions in `linux-game-manager.sh`:
|
|
|
|
```bash
|
|
rg -n "game_installer|game_launcher|game_removal|game_update|getopts|help\\(" linux-game-manager.sh
|
|
```
|
|
|
|
3. Update skill references:
|
|
- Update `references/core-map.md` catalog snapshot if counts changed.
|
|
- Update `references/core-map.md` flow descriptions if behavior changed.
|
|
- Update `references/game-extension.md` if onboarding or naming rules changed.
|
|
- Update this file if refresh triggers or process changed.
|
|
|
|
4. Validate the skill structure:
|
|
|
|
```bash
|
|
python3 /home/storm/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/linux-game-manager-dev
|
|
```
|
|
|
|
5. If any bash scripts changed, run shellcheck on edited files and fix all errors.
|
|
- If `shellcheck` is missing, pause and prompt the user to install it using `references/tooling-prereqs.md`.
|
|
|
|
## Completion Criteria
|
|
|
|
Do not consider maintenance complete until all are true:
|
|
|
|
1. Catalog audit shows no critical mismatches, and any warnings are reviewed.
|
|
2. All changed behavior is reflected in skill reference files.
|
|
3. Skill passes `quick_validate.py`.
|
|
4. Any edited bash scripts are shellcheck-clean.
|