SuperAPI AI Directory

project-guide

Coding & development

View repository

Updated 10-16 00:00

About this skill

Axhub Make project guidance

You are assisting the user with Axhub Make. Please first read AGENTS.md to get the project workflow and specification index.

📚 Project reference materials

When users encounter problems, they can look for answers in the following locations:

Location Purpose
AGENTS.md The project's main entry point, describing the workflow (creating prototypes, resource management), important principles, and project structure
rules/ Detailed specifications for each area: development specifications, design specifications, documentation specifications, theme specifications, debugging guides, etc.
scripts/ Build scripts and tool scripts: entry scanning, batch building, code review, format conversion, and other automation tools
skills/ Project skills and workflows: complete operation processes including creating prototypes, themes, documents, data tables, design reviews, memory consolidation, etc.

🔍 Project status detection

When the user's intent is unclear, they are a newcomer, or they request guidance, perform the following checks:

Check 1: Whether it is a new project

  • View the src/prototypes/ directory
  • The directory is empty or contains only reference prototypes with the ref-* prefix → New project
  • Prototypes created by the user exist → Existing project

Check 2: Whether the project information is complete

  • Read the .axhub/make/axhub.config.json in projectInfo.name and projectInfo.description
  • If it is empty or a default value → Suggest supplementing the project name and one-sentence introduction

Check 3: Whether there is a default theme

  • Check whether the src/themes/ directory has a theme folder
  • No → Suggest creating and setting a default theme
  • There is a theme but no default is set → Suggest setting a default theme

Check 4: Whether content needs to be consolidated

  • Compare the number of prototypes with the number of documents/data tables
  • There are many prototypes but src/docs/ and src/database/ have little content → Suggest organizing project documents and data tables

Check 5: Whether the design needs Review

  • There are newly added or recently modified prototypes that have not been reviewed → Suggest conducting a design Review

Check 6: Whether Git version management is enabled (existing projects only)

This check is performed only when it is determined to be an "existing project" (not newcomer guidance).

  • Check whether the .git directory exists in the project root directory
  • Does not exist → Suggest the user enable Git version management, explaining the benefits:
    • Prevent code loss caused by accidental operations, and allow rollback to any historical version at any time
    • Conveniently track the content and reasons of each modification
    • Support branch management during multi-person collaboration
  • Already exists → no additional action needed

🚀 Recommended process

New project users

  1. Supplement basic project information — name and one-sentence introduction
  2. First try creating 1-2 prototypes
  3. Create a theme(after the first few prototypes)
  4. Gradually expand to 5-10 modules/pages

Existing project users (best practice loop)

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

Recommended checkpoints

Stage Trigger condition Recommended action
Getting started New project, no prototypes at all First create 1-2 prototypes
Basics 2-3 prototypes but no theme Create a default theme
Expansion Has a theme, 3+ prototypes Expand to 5-10 modules
Consolidation 5+ prototypes but little documentation/data Consolidate documentation and data
Review New prototypes added but not reviewed Design review
Cycle All of the above completed Continue iterating

💬 Conversation tips

Topic Suggestion Reason
Communication materials Provide as many screenshots as possible; if convenient, use voice input to describe requirements Visual information is more precise than text descriptions, and voice input is 3-5 times more efficient than typing
Conversation approach One task per conversation window, avoid mixing multiple tasks together The more focused the context, the higher the quality of the AI's output; mixed tasks easily lead to omissions and mutual interference
Providing materials Prioritize giving any links, screenshots, or documents you have Reduce AI guessing and repeated confirmation; providing sufficient references at once can significantly reduce back-and-forth rounds
MCP tools It is recommended to install Chrome DevTools MCP or Playwright MCP The AI can directly inspect and control the browser, eliminating the back-and-forth of "take a screenshot for me to look at"

💡 Recommended models

Model Features
Claude Opus 4.6 Strong overall capabilities, excellent at both code and reasoning, top recommendation
Gemini 2.5 Pro Google flagship, outstanding long-context handling
GPT-5.4 OpenAI's latest, strong instruction-following ability
Kimi K2.5 Excellent Chinese understanding, suitable for Chinese-intensive scenarios
GLM-5.1 Top domestic open-source, free to use

📋 First reply template

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

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

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

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