Files
ONE-OS/axhub-make/skills/skills-management/references/change-playbook.md
王冕 a27e3b8e43 feat: sync full workspace including web modules, docs, and configurations to Gitea
Optimized the root .gitignore to exclude virtual environments, node modules,
and temp folders to ensure clean and lightweight version tracking.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-09 18:12:25 +08:00

2.1 KiB
Raw Blame History

技能维护操作手册

修改前统一备份

先创建备份目录:

mkdir -p .axhub/make/backups/skills/<timestamp>/

然后备份本次要改的内容:

  • manifest 文件
  • skill 目录

建议保留原相对路径,便于恢复。

常见操作

1. 新增首页“项目 Skills”卡片

要改:

  • apps/axhub-make/.axhub/make/skills/install-skills-manifest.default.json
  • 如有新技能正文,再新增 apps/axhub-make/skills/<skill-id>/

适用于“要作为官方默认发布”的情况。

2. 只在当前项目覆盖首页“项目 Skills”

要改:

  • apps/axhub-make/.axhub/make/skills/install-skills-manifest.json

如果文件不存在:

  • 先参考 install-skills-manifest.default.json 创建完整副本
  • 再按当前项目需要修改

3. 修改新建组件/原型里的技能列表

官方默认:

  • skills-manifest.default.json

当前项目自定义:

  • skills-manifest.json

4. 修改新建文档里的技能列表

官方默认:

  • doc-skills-manifest.default.json

当前项目自定义:

  • doc-skills-manifest.json

5. 修改新建主题里的技能列表

官方默认:

  • theme-skills-manifest.default.json

当前项目自定义:

  • theme-skills-manifest.json

6. 修改某个技能正文

要改:

  • apps/axhub-make/skills/<skill-id>/SKILL.md
  • apps/axhub-make/skills/<skill-id>/references/...

7. 恢复官方默认技能到当前项目

如果用户想恢复默认:

  1. 打开对应的 *.default.json
  2. 找到需要恢复的技能条目
  3. apps/axhub-make/skills/<skill-id>/ 取回官方文档
  4. 如果当前项目有自定义 manifest先以 *.default.json 为基底重建完整清单,再补回仍需要的自定义项

不要混淆的概念

  • “项目 Skills”卡片列表由 install-skills-manifest.*.json 控制
  • “新建组件 / 原型”技能列表由 skills-manifest.*.json 控制
  • “新建文档”技能列表由 doc-skills-manifest.*.json 控制
  • “新建主题”技能列表由 theme-skills-manifest.*.json 控制

它们不是同一份文件。