88 lines
4.0 KiB
Markdown
88 lines
4.0 KiB
Markdown
# 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 业务代码；相关代码可以作为现有项目参考进行分析。
|
|
|
|
## 协作方式
|
|
|
|
- 先读取项目上下文，再确定最小改动范围。
|
|
- 复杂任务先拆分为分析、实现、验证和收尾步骤。
|
|
- 编辑前说明将修改的文件和行为。
|
|
- 完成后报告实际改动、验证结果和仍存在的限制。
|
|
- 遇到明确冲突或缺少关键业务约定时，停止并请求澄清。
|