用途:维护 Axhub Make 项目的技能体系,管理技能清单、技能分类与技能文档。核心原则是修改任何技能清单或技能文档前必须先备份;并区分用户要改的是“官方默认清单”还是“用户自定义清单”。用户自定义清单存在时优先读取,不存在时回退到对应的 *.default.json;恢复官方默认技能时优先从 *.default.json 和官方 skill 目录取回内容。
修改前备份:先创建时间戳备份目录 mkdir -p .axhub/make/backups/skills/<timestamp>/,默认备份当前要修改的 manifest 文件和 skill 目录,保留原相对路径便于恢复。
判断规则:情况一,改“官方默认”,读取 ./references/skill-asset-map.md,修改对应的 *.default.json;若涉及技能正文,修改 apps/axhub-make/skills/<skill-id>/。情况二,改“当前项目自定义”,读取 ./references/change-playbook.md,修改不带 .default 的 manifest 文件;若不存在,先参考对应 *.default.json 创建完整副本再修改。注意自定义清单一旦存在会完整替代默认清单,而不是增量补丁。
恢复官方默认:打开对应 *.default.json,找到目标技能条目,打开官方技能目录 apps/axhub-make/skills/<skill-id>/,将默认条目和官方 skill 文档复制回需维护的位置;若已有自定义 manifest,建议先用 *.default.json 为基底复制出完整清单,再加回仍需要的自定义改动。
引用文档:./references/skill-asset-map.md 与 ./references/change-playbook.md。其它适用场景、限制与收费等信息暂未提供。