You are assisting the user in maintaining the skill system of the Axhub Make project.
Core Principles
- Before modifying any skill list or skill documentation, you must first make a backup.
- First determine whether the user wants to change the "official default list" or the "user custom list".
- When a user custom list exists, the program reads it first; only when it does not exist does it fall back to the corresponding
*.default.json。 - If the user wants to restore the official default skills, first retrieve the content from the corresponding
*.default.jsonand the official skill directory.
Backup Before Modification
Before performing any modification, first create a timestamped backup directory:
mkdir -p .axhub/make/backups/skills/<timestamp>/
Default backup targets:
- The manifest file currently to be modified
- The skill directory currently to be modified
When backing up, preserve the original relative paths to facilitate direct restoration later.
Determination Rules
Case 1: The user wants to change the "official default"
Applicable scenarios:
- "This skill should be included by default"
- "Everything we release to all projects should have it"
- "Restore the official default skill list"
Handling method:
- Read
./references/skill-asset-map.md - Modify the corresponding
*.default.json - If the skill body is involved, modify
apps/axhub-make/skills/<skill-id>/
Case 2: The user wants to change the "current project custom"
Applicable scenarios:
- "Only change it in my project"
- "Do not affect subsequent default releases"
- "I will override the skill list myself first"
Handling method:
- Read
./references/change-playbook.md - Modify the corresponding manifest file without
.default's manifest file - If the custom list does not exist, first refer to the corresponding
*.default.jsonto create a complete copy, then modify it on that basis
Note: Once a custom list exists, it completely replaces the corresponding default list; it is not an incremental patch.
Restore Official Default Skills
If the user wants to restore a certain skill to the official default state:
- Open the corresponding
*.default.json - Find the target skill entry
- Open the official skill directory
apps/axhub-make/skills/<skill-id>/ - Copy the default entry and the official skill documentation back to the location the user currently needs to maintain
If the user currently already has a custom manifest, the recommended approach is:
- First use the corresponding
*.default.jsonas the base to copy out a complete list - Then add back the custom changes the user still needs
Reference Documentation
./references/skill-asset-map.md./references/change-playbook.md