a27e3b8e43
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>
132 lines
5.0 KiB
Markdown
132 lines
5.0 KiB
Markdown
---
|
||
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. 一个任务尽量放在一个对话里，效果会更稳定
|
||
|
||
如果你愿意，顺手告诉我这个项目的名称，或者用一句话介绍它是做什么的、给谁用。我可以先帮你整理并写进项目配置。
|
||
|
||
我们现在就可以先试试生成一个原型，或者先一起整理现有项目资料。
|
||
```
|