准备数据

“准备数据”通常指创建或修改数据模型、查询、字段、过滤条件、数据源配置或取数逻辑。AI 可以辅助理解表结构、生成查询草稿和检查字段引用，但涉及数据写入和数据源变更时必须人工确认。

阅读顺序

1. 先读 SuccApp 官方文档 Skill 中的 AI 低代码开发说明和工作区中的 AI 协作文件，确认数据范围、环境、权限和是否只允许只读操作。
2. 再读数据模型、查询、数据源连接和查询数据。
3. 使用 SuccApp CLI 只读命令前，先确认服务器、数据源和模型范围；物理库排查用 db，语义模型排查用 model。
4. 修改后按引用检查、元数据静态检查和产品验证验证影响范围。

常见文件和工具

对象	用途
.tbl	数据模型、字段、物理表和取数配置。
.query	查询 DSL 或数据准备逻辑。
.jdbc	数据源连接配置。
SuccApp CLI db 命令	查看数据源、schema、表结构和执行只读查询。
SuccApp CLI model 命令	查看 .tbl 模型摘要、字段、索引，并通过模型表达式或 Query DSL 查询模型数据。

AI 修改前

明确告诉 AI：

1. 目标业务问题和数据口径。
2. 数据源、schema、表名和字段范围。
3. 是否只允许只读查询。
4. 是否允许修改 .tbl、.query 或 .jdbc。
5. 是否涉及生产数据、敏感数据或数据写入。

推荐流程

1. 使用 succapp db source list、schema list、table describe 读取物理结构；使用 succapp model list、model show、model fields 读取语义模型结构。
2. 让 AI 先解释字段和表关系，不要直接执行写 SQL。
3. 需要 SQL 或模型查询时先生成只读查询并限制行数；单模型查询优先用 succapp model select <model> --where "STATUS='ACTIVE'" --max-rows 20。
4. 修改模型或查询文件前，搜索页面、报表和脚本引用。
5. 修改后验证依赖该模型的页面、看板和报表。

安全边界

以下操作必须人工确认：

1. succapp db exec。
2. 导入、删除或更新业务数据。
3. 修改数据源配置。
4. 修改模型主键、物理表名、字段编码和权限相关字段。
5. 在生产数据源上执行大范围查询。

更多说明见查询数据和安全边界。