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	国产开源榜首，免费可用

📋 首次回复模板

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

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

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

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