App.k12.Parents/ASSISTANT_CAPABILITIES.md

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 业务代码；相关代码可以作为现有项目参考进行分析。

协作方式

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