---
name: project-guide
description: Axhub Make 项目全流程引导 — 判断项目状态，指导用户高效使用
---

# Axhub Make 项目引导

你正在协助用户使用 Axhub Make。请先阅读 `AGENTS.md` 获取项目工作流程和规范索引。

## 📚 项目参考资料

用户遇到问题时，可以在以下位置查找答案：

| 位置 | 作用 |
|------|------|
| `AGENTS.md` | 项目总入口，描述工作流程（新建原型、资源管理）、重要原则和项目结构 |
| `rules/` | 各领域的详细规范：开发规范、设计规范、文档规范、主题规范、调试指南等 |
| `scripts/` | 构建脚本与工具脚本：入口扫描、批量构建、代码审查、格式转换等自动化工具 |
| `skills/` | 项目技能与工作流：包含创建原型、主题、文档、数据表、设计审查、记忆沉淀等完整操作流程 |

---

## 🔍 项目状态检测

当用户意图不明确、是新人、或请求指导时，执行以下检查：

### 检查 1：是否为新项目

- 查看 `src/prototypes/` 目录
- 目录为空或仅包含 `ref-*` 前缀的参考原型 → **新项目**
- 存在用户自己创建的原型 → **已有项目**

### 检查 2：项目信息是否完善

- 读取 `.axhub/make/axhub.config.json` 中的 `projectInfo.name` 和 `projectInfo.description`
- 如果为空或为默认值 → **建议补充项目名称和一句话简介**

### 检查 3：是否有默认主题

- 查看 `src/themes/` 目录是否有主题文件夹
- 没有 → **建议创建并设置默认主题**
- 有主题但未设置默认 → **建议设置默认主题**

### 检查 4：内容是否需要沉淀

- 对比原型数量与文档/数据表数量
- 原型较多但 `src/docs/` 和 `src/database/` 内容较少 → **建议整理项目文档和数据表**

### 检查 5：设计是否需要 Review

- 有新增或近期修改的原型且未进行过 review → **建议进行一次设计 Review**

### 检查 6：是否开启 Git 版本管理（仅已有项目）

> 此检查仅在判定为"已有项目"（非新人引导）时执行。

- 检查项目根目录是否存在 `.git` 目录
- 不存在 → **建议用户开启 Git 版本管理**，说明好处：
  - 防止误操作导致代码丢失，可随时回退到任意历史版本
  - 方便追踪每次修改的内容和原因
  - 支持多人协作时的分支管理
- 已存在 → 无需额外操作

## 🚀 推荐流程

### 新项目用户

1. **补充项目基本信息** — 名称和一句话简介
2. **先试试创建 1-2 个原型**
3. **创建主题**（前几个原型之后）
4. **逐步扩展到 5-10 个模块/页面**

### 已有项目用户（最佳实践循环）

```
完善项目信息（名称、简介）
  ↓
创建并设置默认主题（如果没有）
  ↓
创建 5-10 个功能模块/页面原型
  ↓
定期让 AI Review 设计一致性
  ↓
沉淀项目资产（整理文档、数据、主题）
  ↓
创建更多原型 → Review → 沉淀 → 循环
```

### 推荐检查点

| 阶段 | 触发条件 | 推荐动作 |
|------|----------|----------|
| 起步 | 新项目，无任何原型 | 先创建 1-2 个原型 |
| 基础 | 有 2-3 个原型但无主题 | 创建默认主题 |
| 扩展 | 有主题、3+ 原型 | 扩展到 5-10 个模块 |
| 整理 | 5+ 原型但文档/数据少 | 沉淀文档和数据 |
| 审查 | 有新增原型未 review | 设计 Review |
| 循环 | 以上均完成 | 继续迭代 |

## 💬 对话技巧

| 主题 | 建议 | 理由 |
| --- | --- | --- |
| 沟通素材 | 尽量多给截图；方便的话用语音输入法描述需求 | 视觉信息比文字描述更精确，语音输入效率比打字高 3-5 倍 |
| 会话方式 | 一个任务一个对话窗口，避免多任务混在一起 | 上下文越集中，AI 的输出质量越高；混合任务容易导致遗漏和互相干扰 |
| 资料提供 | 手里有链接、截图、文档的优先给 | 减少 AI 猜测和反复确认，一次给足参考能显著减少来回轮次 |
| MCP 工具 | 建议安装 Chrome DevTools MCP 或 Playwright MCP | AI 可直接检查和操控浏览器，省去"帮我截个图看看"的来回沟通 |

## 💡 推荐模型

| 模型 | 特点 |
|------|------|
| Claude Opus 4.6 | 综合能力强，代码和推理均优秀，首选推荐 |
| Gemini 2.5 Pro | Google 旗舰，长上下文处理出色 |
| GPT-5.4 | OpenAI 最新，指令遵循能力强 |
| Kimi K2.5 | 中文理解优秀，适合中文密集场景 |
| GLM-5.1 | 国产开源榜首，免费可用 |

## 📋 首次回复模板

```text
我可以先带你一起用 Axhub Make 开始工作。

先给你几个重要的建议：
1. 尽量多给我截图、链接或文档，还有使用语音输入，提高沟通效率
2. 一个任务尽量放在一个对话里，效果会更稳定

如果你愿意，顺手告诉我这个项目的名称，或者用一句话介绍它是做什么的、给谁用。我可以先帮你整理并写进项目配置。

我们现在就可以先试试生成一个原型，或者先一起整理现有项目资料。
```