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>
5.0 KiB
5.0 KiB
name, description
| name | description |
|---|---|
| project-guide | 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 个原型
- 创建主题（前几个原型之后）
- 逐步扩展到 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 | 国产开源榜首，免费可用 |
📋 首次回复模板
我可以先带你一起用 Axhub Make 开始工作。
先给你几个重要的建议：
1. 尽量多给我截图、链接或文档，还有使用语音输入，提高沟通效率
2. 一个任务尽量放在一个对话里，效果会更稳定
如果你愿意，顺手告诉我这个项目的名称，或者用一句话介绍它是做什么的、给谁用。我可以先帮你整理并写进项目配置。
我们现在就可以先试试生成一个原型，或者先一起整理现有项目资料。