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:
56
axhub-make/skills/create-workflow/SKILL.md
Normal file
56
axhub-make/skills/create-workflow/SKILL.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
name: create-workflow
|
||||
description: Axhub Make 创建内容入口;当用户要创建原型/组件、文档、主题或数据表时,根据提示词分流到对应引用文档,并按需渐进式加载。
|
||||
---
|
||||
|
||||
# Axhub Make 创建内容工作流
|
||||
|
||||
你正在协助用户在 Axhub Make 中创建新资源。请先阅读 `/AGENTS.md` 获取项目结构、命名规范与基础约束。
|
||||
|
||||
## 核心原则
|
||||
|
||||
- 先识别创建目标,再只加载一个最相关的引用文档。
|
||||
- 不要一次性读取全部引用文档。
|
||||
- 如果用户在一个请求里同时提到多个资源,先判断主产物,再按需补充读取其他引用文档。
|
||||
- 当主任务已经确定时,其他资源默认作为参考输入,而不是切换工作流。
|
||||
- 只有当用户明确改变目标,或当前任务确实需要额外创建另一类资源时,才加载第二个引用文档。
|
||||
|
||||
## 意图分流
|
||||
|
||||
| 用户意图 / 关键词 | 加载文档 | 典型产物 |
|
||||
| --- | --- | --- |
|
||||
| 原型、页面、组件、做个页面、做个组件 | `./references/create-prototype.md` | `src/prototypes/...` 或 `src/components/...` |
|
||||
| 文档、PRD、说明文档、需求文档、手册 | `./references/create-document.md` | `src/docs/...` |
|
||||
| 主题、设计系统、配色、design token、DESIGN.md | `./references/create-theme.md` | `src/themes/...` |
|
||||
| 数据、数据表、JSON、mock 数据、示例数据 | `./references/create-data.md` | `src/database/...` |
|
||||
|
||||
## 分流优先级
|
||||
|
||||
1. 用户明确点名输出目录或文件类型时,按目标产物分流:
|
||||
- 提到 `spec.md`、`index.tsx`、页面、组件 -> 原型 / 组件
|
||||
- 提到 `DESIGN.md`、`designToken.json`、`globals.css` -> 主题
|
||||
- 提到 `.json` 数据表、`records`、mock 数据 -> 数据
|
||||
- 提到 PRD、说明文档、手册、Markdown -> 文档
|
||||
2. 如果同一提示里既有“创建原型”又有“参考主题 / 文档 / 数据”,优先加载原型工作流,把主题 / 文档 / 数据当作上下文资料。
|
||||
3. 如果用户只说“帮我创建一个”,目标不明确时,不要盲猜,先用下方模板补齐。
|
||||
|
||||
## 模糊意图时的首次回复模板
|
||||
|
||||
```text
|
||||
收到,我可以帮你创建内容。
|
||||
|
||||
先告诉我这次主要要创建哪一类:
|
||||
1. 原型 / 组件
|
||||
2. 文档
|
||||
3. 主题
|
||||
4. 数据表
|
||||
|
||||
再补一句你的目标和使用场景,我就按对应流程继续。
|
||||
```
|
||||
|
||||
## 引用文档
|
||||
|
||||
- `./references/create-prototype.md`
|
||||
- `./references/create-document.md`
|
||||
- `./references/create-theme.md`
|
||||
- `./references/create-data.md`
|
||||
69
axhub-make/skills/create-workflow/references/create-data.md
Normal file
69
axhub-make/skills/create-workflow/references/create-data.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# 创建数据
|
||||
|
||||
创建页面可直接消费的数据表的标准流程,数据统一存放在 `src/database/` 目录。
|
||||
|
||||
## 角色定位
|
||||
|
||||
你将作为 **数据架构师 × 产品经理(复合型)**,协助用户完成数据表的设计与创建。
|
||||
|
||||
## 核心流程
|
||||
|
||||
收到用户需求 -> 阅读规范 -> 需求对齐 -> 设计数据结构 -> 输出数据文件
|
||||
|
||||
### 步骤 1:阅读规范文档
|
||||
|
||||
**必须完整阅读以下文档**:
|
||||
|
||||
1. **`/rules/resource-management-guide.md`** 资源管理规范
|
||||
- 了解资产目录结构与数据放置规则
|
||||
2. **`/src/database/README.md`** 数据库规范
|
||||
- 数据表格式、字段约束、命名规则
|
||||
|
||||
### 步骤 2:需求对齐
|
||||
|
||||
首次回复必须使用以下模板,等待用户补充信息后再继续:
|
||||
|
||||
```text
|
||||
收到,准备创建数据表。
|
||||
|
||||
请详细描述您的需求:
|
||||
- 数据表用途(用户列表、产品目录、订单记录等)
|
||||
- 主要字段
|
||||
- 示例数据(如有)
|
||||
```
|
||||
|
||||
### 步骤 3:数据表设计与输出
|
||||
|
||||
- 设计数据结构与字段定义
|
||||
- 生成示例数据记录
|
||||
- 输出 JSON 格式的数据文件
|
||||
|
||||
## 数据表结构(强约束)
|
||||
|
||||
每个文件必须是 JSON 对象,包含 `tableName` + `records`:
|
||||
|
||||
```json
|
||||
{
|
||||
"tableName": "表名(中文)",
|
||||
"records": [
|
||||
{ "id": 1, "字段1": "值1", "字段2": "值2" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**最小一致性规则**:
|
||||
|
||||
- `records` 必须是数组;每条记录必须包含唯一的 `id`
|
||||
- 字段名优先中文并与页面一致
|
||||
- 同字段同类型
|
||||
- 图片字段用相对路径(如 `images/xxx.png`),不要 base64
|
||||
|
||||
## 输出文件
|
||||
|
||||
- `src/database/<table-name>.json` - 数据表文件
|
||||
- 文件名使用英文(如 `users.json`)
|
||||
- `tableName` 使用中文(如 "用户表")
|
||||
|
||||
## 参考
|
||||
|
||||
`rules/resource-management-guide.md` | `src/database/README.md`
|
||||
@@ -0,0 +1,48 @@
|
||||
# 创建文档
|
||||
|
||||
创建项目文档的标准流程,文档统一存放在 `src/docs/` 目录。
|
||||
|
||||
## 角色定位
|
||||
|
||||
你将作为 **文档工程师 × 产品经理(复合型)**,协助用户完成文档的创建与结构化整理。
|
||||
|
||||
## 核心流程
|
||||
|
||||
收到用户需求 -> 阅读资源规则 -> 需求对齐 -> 生成文档
|
||||
|
||||
### 步骤 1:阅读规范文档
|
||||
|
||||
**必须完整阅读以下文档**:
|
||||
|
||||
1. **`/rules/resource-management-guide.md`** 资源管理规范
|
||||
- 了解资产目录结构与文档放置规则
|
||||
2. **`/rules/documentation-guide.md`** 文档编写规范
|
||||
- 文档格式、命名、结构等要求
|
||||
|
||||
### 步骤 2:需求对齐
|
||||
|
||||
首次回复必须使用以下模板,等待用户补充信息后再继续:
|
||||
|
||||
```text
|
||||
收到,准备创建文档。
|
||||
|
||||
请详细描述您的需求:
|
||||
- 文档类型(需求文档、设计说明、用户手册等)
|
||||
- 目标读者
|
||||
- 主要内容方向
|
||||
```
|
||||
|
||||
### 步骤 3:文档生成
|
||||
|
||||
- 根据用户需求组织文档结构
|
||||
- 参考已有项目文档和数据源补充上下文
|
||||
- 输出 Markdown 格式的文档
|
||||
|
||||
## 输出文件
|
||||
|
||||
- `src/docs/<doc-name>.md` - 文档文件
|
||||
- `src/docs/assets/` - 文档配图等附属资源(如需要)
|
||||
|
||||
## 参考
|
||||
|
||||
`rules/resource-management-guide.md` | `rules/documentation-guide.md`
|
||||
@@ -0,0 +1,61 @@
|
||||
# 创建原型 / 组件
|
||||
|
||||
创建一个新的原型页面或 UI 组件的标准流程。
|
||||
|
||||
## 角色定位
|
||||
|
||||
你将作为 **UI/UX 设计架构师 × 前端工程师(复合型)**,协助用户完成原型或组件的创建。
|
||||
|
||||
## 核心流程
|
||||
|
||||
收到用户需求 -> 阅读规范 -> 设计(spec.md) -> 开发(index.tsx) -> 验收
|
||||
|
||||
### 步骤 1:阅读规范文档
|
||||
|
||||
**必须完整阅读以下文档**,不可跳过:
|
||||
|
||||
1. **`/rules/design-guide.md`** 设计流程
|
||||
- 资料收集、业务场景识别、数据源查找、内容规划、视觉设计
|
||||
2. **`/rules/development-standards.md`** 开发规范
|
||||
- 文件结构、依赖引用、样式规范、导出规范
|
||||
- 完成后必须对照此文档检查实现
|
||||
3. **`/docs/templates/spec-template.md`** 规格文档模板
|
||||
- 使用此模板生成 `spec.md`
|
||||
|
||||
### 步骤 2:需求对齐
|
||||
|
||||
首次回复必须使用以下模板,等待用户补充信息后再继续:
|
||||
|
||||
```text
|
||||
收到,准备创建原型或组件。
|
||||
|
||||
请详细描述您的需求:
|
||||
```
|
||||
|
||||
### 步骤 3:设计与规格文档
|
||||
|
||||
- 根据用户需求完成布局与视觉方向设计
|
||||
- 产出 `spec.md` 规格文档
|
||||
|
||||
### 步骤 4:开发与验收
|
||||
|
||||
- 根据 spec 实现原型 / 组件代码
|
||||
- 运行验收流程确认功能正常
|
||||
|
||||
## 输出文件
|
||||
|
||||
如果目标是原型:
|
||||
|
||||
- `src/prototypes/<page-name>/spec.md` - 规格文档
|
||||
- `src/prototypes/<page-name>/index.tsx` - 页面组件
|
||||
- `src/prototypes/<page-name>/style.css` - 样式文件
|
||||
|
||||
如果目标是组件:
|
||||
|
||||
- `src/components/<component-name>/spec.md` - 规格文档
|
||||
- `src/components/<component-name>/index.tsx` - 组件实现
|
||||
- `src/components/<component-name>/style.css` - 样式文件
|
||||
|
||||
## 参考
|
||||
|
||||
`rules/design-guide.md` | `rules/development-standards.md`
|
||||
53
axhub-make/skills/create-workflow/references/create-theme.md
Normal file
53
axhub-make/skills/create-workflow/references/create-theme.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# 创建主题
|
||||
|
||||
创建项目主题的标准流程,主题统一存放在 `src/themes/` 目录。
|
||||
|
||||
## 角色定位
|
||||
|
||||
你将作为 **UI/UX 设计师 × 主题架构师(复合型)**,协助用户完成设计主题的创建。
|
||||
|
||||
## 核心流程
|
||||
|
||||
收到用户需求 -> 阅读规范 -> 需求对齐 -> 设计主题 -> 输出主题文件
|
||||
|
||||
### 步骤 1:阅读规范文档
|
||||
|
||||
**必须完整阅读以下文档**:
|
||||
|
||||
1. **`/rules/resource-management-guide.md`** 资源管理规范
|
||||
- 了解资产目录结构与主题放置规则
|
||||
2. **`/rules/theme-guide.md`** 主题开发规范
|
||||
- 主题文件结构、设计令牌格式、CSS 变量规范
|
||||
|
||||
### 步骤 2:需求对齐
|
||||
|
||||
首次回复必须使用以下模板,等待用户补充信息后再继续:
|
||||
|
||||
```text
|
||||
收到,准备创建主题。
|
||||
|
||||
请详细描述您的需求:
|
||||
- 风格方向(现代 / 极简 / 活泼 / 商务等)
|
||||
- 主色系偏好
|
||||
- 参考案例或网站(如有)
|
||||
```
|
||||
|
||||
### 步骤 3:主题设计与输出
|
||||
|
||||
- 设计颜色体系(Primary、Secondary、Neutral、Semantic)
|
||||
- 定义字体搭配(标题、正文、代码)
|
||||
- 设计间距、圆角、阴影等视觉变量
|
||||
- 产出设计规范文档与主题文件
|
||||
|
||||
## 输出文件
|
||||
|
||||
主题目录结构 `src/themes/<theme-key>/`:
|
||||
|
||||
- `DESIGN.md` - 设计规范文档
|
||||
- `designToken.json` - 设计令牌(必须包含 `name` 字段)
|
||||
- `globals.css` - 全局 CSS 变量
|
||||
- `index.tsx` - 主题组件(如需要)
|
||||
|
||||
## 参考
|
||||
|
||||
`rules/resource-management-guide.md` | `rules/theme-guide.md`
|
||||
Reference in New Issue
Block a user