用途:为使用 Cursor、Qoder 等 AI Coding 工具的开发者提供项目开发规范,强调测试即规范、精准定位、无冗余输出,覆盖认证系统、组织架构、Agent Studio、数据同步与个人中心等模块迭代。
主要能力:动态上下文感知,按任务关键词与文件路径自动加载文档与约束;TDD 红-绿-重构循环,新功能先写测试、Bug 修复先写复现测试;Agent Studio 扩展,包含后端工具定义、前端工具目录、注册表与 System Prompt 说明,支持 A2UI 白名单组件与 Action ID 规范;设计系统规范要求 Tailwind CSS v4 语法与语义化颜色,移动端覆盖层须显式颜色加 dark: 前缀;数据访问统一走 DataService,SQL 变更集中于 setup.sql;Bug 修复遵循先查数据再改代码。
使用方式:开发用 npm run dev 或 npm run dev:test,TDD 用 npm run test:watch,质量验证运行 npm run ai:check 或 ./scripts/quality_check.sh,E2E 用 npm run test:e2e:headless。
适用场景:React 19、TypeScript、Vite、Supabase、Zustand、Vitest、Cypress 技术栈下的 AI 辅助迭代开发。
限制:禁止硬编码颜色、any 类型、直接导入 supabase client、创建独立 SQL 迁移文件、在 A2UI 使用未注册组件、直接调用 LLM API(须经 ai-assistant Edge Function);先写代码后补测试、无测试覆盖提交等被禁止。具体收费、价格、平台支持与效果数据暂未提供。