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>
This commit is contained in:
王冕
2026-06-09 18:12:25 +08:00
parent 351688006e
commit a27e3b8e43
1510 changed files with 162044 additions and 1517 deletions

View File

@@ -0,0 +1,81 @@
---
name: skills-management
description: Axhub Make 技能管理入口,用于维护项目技能清单、技能分类与技能文档,并在修改前执行备份。
---
# 技能管理
你正在协助用户维护 Axhub Make 项目的技能体系。
## 核心原则
- 修改任何技能清单或技能文档前,必须先做备份。
- 先判断用户要改的是“官方默认清单”还是“用户自定义清单”。
- 用户自定义清单存在时,程序优先读取它;不存在时才回退到对应的 `*.default.json`
- 如果用户想恢复官方默认技能,优先从对应的 `*.default.json` 和官方 skill 目录取回内容。
## 修改前备份
在执行任何修改前,先创建时间戳备份目录:
```bash
mkdir -p .axhub/make/backups/skills/<timestamp>/
```
默认备份对象:
- 当前要修改的 manifest 文件
- 当前要修改的 skill 目录
备份时保留原相对路径,便于后续直接恢复。
## 判断规则
### 情况 1用户要改“官方默认”
适用场景:
- “这个技能默认就要带上”
- “我们发布给所有项目都要有”
- “恢复官方默认技能列表”
处理方式:
- 读取 `./references/skill-asset-map.md`
- 修改对应的 `*.default.json`
- 如果涉及技能正文,修改 `apps/axhub-make/skills/<skill-id>/`
### 情况 2用户要改“当前项目自定义”
适用场景:
- “只在我这个项目里改”
- “不要影响后续默认发布”
- “我自己先覆盖一下技能列表”
处理方式:
- 读取 `./references/change-playbook.md`
- 修改对应的不带 `.default` 的 manifest 文件
- 若该自定义清单不存在,先参考对应的 `*.default.json` 创建完整副本,再在此基础上修改
> 注意:自定义清单一旦存在,就会完整替代对应的默认清单;它不是增量补丁。
## 恢复官方默认技能
如果用户要把某个技能恢复为官方默认状态:
1. 打开对应的 `*.default.json`
2. 找到目标技能条目
3. 打开官方技能目录 `apps/axhub-make/skills/<skill-id>/`
4. 将默认条目和官方 skill 文档重新复制到用户当前需要维护的位置
如果用户当前已经有自定义 manifest推荐做法是
- 先用对应的 `*.default.json` 作为基底复制出完整清单
- 再把用户仍然需要的自定义改动重新加回去
## 引用文档
- `./references/skill-asset-map.md`
- `./references/change-playbook.md`

View File

@@ -0,0 +1,93 @@
# 技能维护操作手册
## 修改前统一备份
先创建备份目录:
```bash
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` 控制
它们不是同一份文件。

View File

@@ -0,0 +1,66 @@
# 技能资产地图
本文档说明 Axhub Make 项目里“技能相关资产”分别存放在哪里,以及它们各自控制什么。
## 官方默认清单
目录:`apps/axhub-make/.axhub/make/skills/`
- `skills-manifest.default.json`
- 控制“新建组件 / 新建原型”对话框里的技能列表
- `doc-skills-manifest.default.json`
- 控制“新建文档”流程里的技能列表
- `theme-skills-manifest.default.json`
- 控制“新建主题”流程里的技能列表
- `install-skills-manifest.default.json`
- 控制首页“项目 Skills”里的项目技能卡片
这些文件是官方维护和发布的默认来源。
## 用户自定义清单
目录:`apps/axhub-make/.axhub/make/skills/`
- `skills-manifest.json`
- `doc-skills-manifest.json`
- `theme-skills-manifest.json`
- `install-skills-manifest.json`
程序读取规则固定为:
- 先读同名自定义 `.json`
- 若不存在,再读对应的 `.default.json`
> 自定义清单一旦存在,就完整替代对应的默认清单。
## 官方技能正文目录
目录:`apps/axhub-make/skills/`
每个技能的官方正文位于:
- `apps/axhub-make/skills/<skill-id>/SKILL.md`
- `apps/axhub-make/skills/<skill-id>/references/...`
如果用户要恢复官方默认技能,请从这里获取技能文档与引用文档。
## 前端读取入口
桥接文件:
- `apps/prototype-admin/src/index/config/skillManifests.ts`
该文件负责在构建时选择“自定义清单”或“默认清单”。
## 项目 Skills 安装来源
首页“项目 Skills”安装按钮最终会从以下目录安装技能
- `apps/axhub-make/skills/<skill-id>/`
因此:
- `install-skills-manifest.default.json` / `install-skills-manifest.json` 里的 `id`
- 官方技能目录名 `apps/axhub-make/skills/<skill-id>/`
这两者必须保持一致。