Neo4j Getting-Started Skill 用于引导用户或智能体从零开始搭建一个可运行的 Neo4j 应用。它按顺序执行 8 个阶段，每个阶段开始时读取对应的参考文件并遵照执行，且只加载当前正在执行的阶段。
用途与何时使用
该技能适用于：从零开始的新 Neo4j 项目（本地、Docker 或 Aura），完整的入门引导（从零到数据库、建模、加载、应用），以及为演示或开发生成合成数据。
不适用于以下场景：在已有项目上编写 Cypher（应使用 neo4j-cypher-skill）、驱动升级或 Cypher 迁移（应使用 neo4j-migration-skill）、对已有数据库执行管理操作如备份、恢复、导入（应使用 neo4j-cli-tools-skill）。
项目结构
所有生成的代码、数据、脚本、查询和笔记本都必须写入工作目录，以便用户在会话结束后检查、复用和重新运行。技能要求将文件按固定布局组织，包括 .env（数据库凭据，被 gitignore，由 python-dotenv 加载）、aura.env（Aura API 凭据，被 gitignore，绝不覆盖）、progress.md（逐阶段进度）、requirements.txt（Python 依赖）；schema 目录下的 schema.json、schema.cypher、reset.cypher；data 目录下的 generate.py、import.py 及 CSV 文件；queries 目录下的 queries.cypher；scripts 目录下的 provision_aura.py；以及根目录下的 notebook.ipynb、app.py、main.py、graphrag_app.py 等应用产物。
进度跟踪
技能在工作目录维护 progress.md 以支持断点续跑。启动时检查该文件是否存在，若存在则找到第一个待处理阶段并从中恢复，读取其上下文块恢复已记录的变量，不再重复询问用户。已完成阶段的文件被视为事实来源，不应凭记忆重建。若 progress.md 不存在，则从 0-prerequisites 开始。
执行协议
每个阶段的流程为：宣布阶段名称与目的、读取对应参考文件、执行其中指令、验证阶段完成条件、更新 progress.md 状态与上下文、进入下一阶段（HITL 模式下需先暂停等待批准）。阶段失败时依据参考文件中的错误指引恢复，除非跳过条件明确允许，否则不得跳过阶段。
8 个阶段
0-prerequisites：验证并安装所需 CLI 工具，完成条件为 neo4j-mcp 二进制可访问且 .gitignore 包含 .env 条目，不可跳过。
1-context：收集领域、用例、经验、基础设施目标、数据源和输出类型，并检测 Cypher 执行方法。
2-provision：创建运行中的 Neo4j 数据库并将凭据保存到 .env。
3-model：为用例设计或发现图数据模型，完成条件为写出 schema.json 和 schema.cypher。
4-load：应用 schema 约束后导入数据（演示、合成、CSV 或文档）。
5-explore：提供图的可视化入口，是硬性关卡，不可跳过。
6-query：生成并验证用例的 Cypher 查询库。
7-build：生成可运行的应用、仪表板、笔记本或智能体集成。
成功门槛
技能包含 7 项成功门槛：db_running（驱动连接校验成功）、model_valid（数据库中至少 2 个节点标签、1 种关系类型、1 个约束）、data_present（节点数不少于 50）、queries_work（至少 5 条查询、2 条遍历、3 条返回结果）、graph_visible（向用户交付浏览器 URL 或笔记本可视化）、app_generated（产物存在、通过语法检查、返回非空用例结果）、integration_ready（如有请求，提供 MCP 配置或智能体框架代码）。
模式与快速路径
技能区分 HITL（对话式，在建模和数据加载后暂停审批）与自主模式（类似 CI，不暂停，全部自动批准，目标在数据库运行后 15 分钟内完成）。自主模式的判定依据包括初始提示是否包含全部上下文变量、是否使用 --auto-approve 等非交互标志、或 progress.md 中是否已记录全部上下文。技能还提供快速路径，例如 DB_TARGET=existing 时跳过创建环节，DATA_SOURCE=demo 时使用演示 schema 等。
已知变量与输出
涉及的关键变量包括 DOMAIN、USE_CASE、EXPERIENCE、DB_TARGET、DATA_SOURCE、APP_TYPE、EXEC_METHOD、NEO4J_URI 等。技能在全部门槛通过后会生成 README.md，并向对话打印完成摘要。