---
title: 任务驱动
description: 说明 AI 如何根据用户问题选择 AI 低代码开发任务文档、读取顺序和验证资料。
navTitle: 任务驱动
---
# 任务驱动

AI 接到 SuccApp 低代码开发问题时，先判断用户要完成什么任务，再进入对应任务文档。不要先按“概念、工具、验证、FAQ”这类资料类型路由；这些内容已经拆到具体任务中。

## 路由方法{#routing}

| 用户说法 | 首选任务 |
| --- | --- |
| 第一次使用、想先跑通流程 | [快速开始](./quick-start.md) |
| 想了解 AI 低代码开发、元数据、工作区、安全边界，或不确定该用 CLI、VS Code 还是 MCP | [了解基础概念和工具](./basics/README.md) |
| 初始化工作区、登录、连接服务器、克隆项目、同步变化 | [准备工作区](./workspace/README.md) |
| 新建或整理项目、目录、资源边界，只改指定文件 | [管理项目](./project/README.md) |
| 查找资源文件、模型文件、字段、路径、依赖，或判断某个 `/项目/...` 路径下有什么 | [定位元数据](./project/find-resource.md) |
| 接数据源、查库表、建模型、加字段、加工、提取、调度、准备测试或演示数据 | [处理数据](./data/README.md) |
| 查询物理层数据、执行只读 SQL、确认数据库产品和 SQL 方言，或查询语义层模型、查看 Query DSL JSON 格式 | [查询数据](./data/query-data.md) |
| 做看板、图表、指标卡、筛选器、可视化分析 | [构建分析可视化](./analytics/README.md) |
| 做报表、填报、参数栏、打印、导出、模板和主题 | [构建报表](./report/README.md) |
| 做业务页面、表单、门户、流程、程序流、移动端应用 | [构建低代码应用](./app/README.md) |
| 给用户或用户组开权限，检查权限和数据范围 | [管理权限](./permission/README.md) |
| 二次开发、定制开发、定制页面、样式、脚本、或外部接口 | [脚本开发](../script/choose-script.md) |
| 开发新数据库、新文件格式、新组件、新流程节点等平台扩展 | [扩展平台能力](./extension/README.md) |
| 冲突、推送失败、登录失败、数据不对、页面没反应、调度没跑 | [排查问题](./troubleshoot/README.md) |
| 校验元数据文件是否合法，或想在浏览器预览前获取 `.dash`、`.spg`、`.tbl` 等文件的编译错误 | [元数据合法性校验](./troubleshoot/metadata-validation.md) |
| 检查 AI 改得对不对，做 diff、引用、产品验证和风险评审 | [质量检查](./quality/README.md) |
| 想在浏览器中打开元数据文件、预览页面效果、进入设计器检查或拿到可访问 URL | [预览文件](./quality/preview-file.md) |
| 准备提交、团队协作、发布生产和回退 | [管理发布](./release/README.md) |
| 想找同类元数据样例 | [通过示例学习](./examples/README.md) |

## 通用读取顺序{#reading-order}

1. 先读当前任务目录的 `README.md`。
2. 根据任务页要求继续读相关元数据格式、DTS、示例和当前项目同类文件。
3. 涉及工作区、服务器或数据库时，补充阅读[准备工作区](./workspace/README.md)和[了解基础概念和工具](./basics/README.md)。
4. 修改完成后，按[质量检查](./quality/README.md)检查 diff、引用、元数据结构和产品运行效果。
5. 需要协作交付或上线时，继续阅读[管理发布](./release/README.md)。

## AI 输出要求{#output}

AI 处理任务时，应向用户说明：

1. 已识别的任务类型和读取的任务文档。
2. 候选项目、目录、文件和判断依据。
3. 修改范围、不会修改的范围和需要人工确认的风险。
4. 实际修改文件清单。
5. 已完成的检查和还需要人工验证的内容。