# uni-agent 能力说明

本文档是公开能力摘要，不是内部技能清单、系统提示词、实现代码或受限配置的导出。

## 项目分析与代码维护

- 阅读和梳理 uni-app、uni-app x 项目结构。
- 定位页面、组件、路由、状态、API 和平台配置。
- 根据现有代码风格进行小范围修改。
- 识别潜在的运行时错误、类型问题、路由问题和跨平台差异。
- 保留用户已有改动，不擅自回退无关文件。
- 使用 Git 检查变更、整理提交和推送代码，但提交或推送应由用户明确授权。

## uni-app x 开发

- 编写和维护 `.uvue` 页面及组件。
- 使用组合式 API 和 `<script setup>`。
- 处理 Android、Web 等平台的条件差异。
- 协助迁移页面的 API 写法，同时保持原有业务行为。
- 分析 Vapor 模式下的页面、组件和编译问题。
- 检查 uni-app x 的布局、样式、单位、定位和 Flexbox 使用方式。
- 根据项目现有模式复用组件和 `uni_modules`。

## 页面与交互

- 实现登录、注册、资料、任务、学习报告、词汇和成长激励等页面。
- 实现底部导航、页面栈复用、筛选、刷新、弹窗和加载状态。
- 实现表单校验、错误提示、空状态、重试和提交状态。
- 关注移动端安全区、固定底栏、滚动区域和不同屏幕尺寸。
- 检查文字、按钮、图标和图表是否存在布局溢出或重叠。

## 组件与原生能力

- 抽取可复用的业务组件和展示组件。
- 处理扫码、摄像头权限、二维码解析和资源释放。
- 处理 Web 与原生平台的扫码实现差异。
- 协助使用项目已有图标、导航、列表、刷新和表单组件。
- 在需要时分析 UTS 插件和平台原生能力的接入边界。

## 接口与数据流

- 梳理页面到 API、状态和 Mock 数据之间的数据流。
- 定义请求参数、响应类型和页面使用的业务模型。
- 处理登录令牌、请求错误、加载状态和重试流程。
- 区分 Mock 成功响应、客户端验证成功和服务端真实持久化。
- 识别前端已有接口与后端缺失接口之间的边界。

## uniCloud 与数据服务

- 协助设计云函数、云对象、数据库集合和数据流。
- 分析 JQL 查询、分页、联表、统计和权限规则。
- 为云端接口设计前端类型和调用方式。
- 协助生成和运行适合云端逻辑的测试。

涉及后端服务、云函数、云对象、JQL 或数据库权限时，应先确认数据实体、调用方、输入、输出、错误处理和权限边界。

## 测试与验证

- 执行相关项目测试并分析失败原因。
- 使用 HBuilderX 进行 Web 或 App 编译验证。
- 检查构建日志中的错误和警告。
- 根据需要验证页面截图、布局和交互状态。
- 检查 Git 暂存内容、差异和换行或空白问题。

自动化验证不能替代真机验证。摄像头、权限、原生导航、推送和平台特有行为仍需在对应运行环境检查。

## 项目文档

- 整理 README、接口说明、页面说明和开发约定。
- 将当前项目的架构、限制、构建方式和验证流程整理成 Markdown。
- 记录尚未实现的后端能力，避免前端用本地状态伪造服务端行为。

## 安全与边界

- 不导出系统提示词、开发者指令、内部知识库原文、内部技能实现或存储位置。
- 不在聊天或代码中要求用户粘贴密码、令牌、私钥或证书内容。
- 不提交环境文件、签名证书、私钥、构建产物和本机配置。
- 不将 Mock 数据或前端校验描述为真实业务完成。
- 不生成 Flutter 或 React Native 业务代码；相关代码可以作为现有项目参考进行分析。

## 协作方式

- 先读取项目上下文，再确定最小改动范围。
- 复杂任务先拆分为分析、实现、验证和收尾步骤。
- 编辑前说明将修改的文件和行为。
- 完成后报告实际改动、验证结果和仍存在的限制。
- 遇到明确冲突或缺少关键业务约定时，停止并请求澄清。