sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/sinapse-agent-flows/architect-system.md

@@ -1,246 +0,0 @@
-# @architect 系统
-
-> **版本:** 1.0.0
-> **创建:** 2026-02-04
-> **所有者:** @architect (Aria - 愿景家)
-> **状态:** 官方文档
-
----
-
-## 概览
-
-**@architect 代理 (Aria)** 是 SINAPSE 的**全系统架构师和全栈技术领导**。该代理负责:
-
-- **完整系统架构**(微服务、单体、无服务器、混合)
-- **技术栈选择**(框架、语言、平台)
-- **基础设施规划**(部署、扩展、监控、CDN)
-- **API 设计**(REST、GraphQL、tRPC、WebSocket)
-- **安全架构**(认证、授权、加密)
-- **前端架构**(状态管理、路由、性能)
-- **后端架构**(服务边界、事件流、缓存)
-- **跨切面关注**(日志、监控、错误处理)
-- **集成模式**(事件驱动、消息、webhooks)
-- **性能优化**(全栈层级)
-
-### 核心原则
-
-1. **全系统思维** - 将每个组件视为更大系统的一部分
-2. **用户体验驱动架构** - 从用户旅程开始，向后工作
-3. **务实的技术选择** - 在可能的地方选择"无聊"技术，在必要的地方选择"激动人心"技术
-4. **渐进复杂性** - 最初设计简单系统，但可扩展
-5. **跨栈性能专注** - 在所有层级整体优化
-6. **开发者体验第一** - 使开发者能够提高生产力
-7. **每层安全** - 实施深度防御
-8. **数据中心设计** - 让数据需求指导架构
-9. **成本意识工程** - 平衡技术理想与财务现实
-10. **活跃架构** - 设计以适应变化
-
----
-
-## 完整文件列表
-
-### @architect 的核心任务文件
-
-| 文件 | 命令 | 目的 |
-|---------|---------|-----------|
-| `.sinapse-ai/development/tasks/architect-analyze-impact.md` | `*analyze-impact` | 分析修改对框架组件的影响 |
-| `.sinapse-ai/development/tasks/document-project.md` | `*document-project` | 生成现有项目的 brownfield 文档 |
-| `.sinapse-ai/development/tasks/create-doc.md` | `*create-doc` | 从 YAML 模板创建文档 |
-| `.sinapse-ai/development/tasks/collaborative-edit.md` | `*collaborative-edit` | 管理协作编辑会话 |
-| `.sinapse-ai/development/tasks/create-deep-research-prompt.md` | `*research` | 生成深度研究提示 |
-| `.sinapse-ai/development/tasks/execute-checklist.md` | `*execute-checklist` | 执行验证检查清单 |
-| `.sinapse-ai/development/tasks/spec-assess-complexity.md` | `*assess-complexity` | 评估故事复杂性(规范管道) |
-
-### 代理定义文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/development/agents/architect.md` | 架构师代理的核心定义 |
-| `.claude/commands/SINAPSE/agents/architect.md` | Claude Code 命令用于激活 @architect |
-
-### @architect 的模板文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/product/templates/architecture-tmpl.yaml` | 后端架构模板 |
-| `.sinapse-ai/product/templates/front-end-architecture-tmpl.yaml` | 前端架构模板 |
-| `.sinapse-ai/product/templates/fullstack-architecture-tmpl.yaml` | 全栈架构模板 |
-| `.sinapse-ai/product/templates/brownfield-architecture-tmpl.yaml` | Brownfield 项目模板 |
-
----
-
-## 命令到任务的映射
-
-### 架构设计命令
-
-| 命令 | 任务文件/模板 | 操作 |
-|---------|---------------------|----------|
-| `*create-full-stack-architecture` | `create-doc.md` + 模板 | 创建完整的全栈架构 |
-| `*create-backend-architecture` | `create-doc.md` + 模板 | 创建后端架构 |
-| `*create-front-end-architecture` | `create-doc.md` + 模板 | 创建前端架构 |
-| `*create-brownfield-architecture` | `create-doc.md` + 模板 | 为现有项目创建架构 |
-
-### 分析命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*analyze-impact` | `architect-analyze-impact.md` | 分析修改影响 |
-| `*assess-complexity` | `spec-assess-complexity.md` | 评估复杂性(5 个维度) |
-| `*research` | `create-deep-research-prompt.md` | 生成研究提示 |
-
-### 文档命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*document-project` | `document-project.md` | 文档化现有项目 |
-| `*execute-checklist` | `execute-checklist.md` | 执行架构检查清单 |
-| `*doc-out` | N/A (内置) | 输出完整文档 |
-| `*shard-prd` | N/A (内置) | 将 PRD 分解为部分 |
-
-### 实用工具命令
-
-| 命令 | 操作 |
-|---------|----------|
-| `*help` | 显示所有可用命令 |
-| `*session-info` | 显示当前会话详情 |
-| `*guide` | 显示代理使用指南 |
-| `*yolo` | 切换跳过确认 |
-| `*exit` | 退出架构师模式 |
-
----
-
-## 复杂性评估 (*assess-complexity)
-
-### 5 个维度
-
-| 维度 | 评分范围 | 示例 |
-|--------|----------|----------|
-| **范围** | 1-5 | 1-2 个文件到 20+ |
-| **集成** | 1-5 | 无到复杂协调 |
-| **基础设施** | 1-5 | 无到新服务器 |
-| **知识** | 1-5 | 现有模式到未知领域 |
-| **风险** | 1-5 | 低到关键 |
-
-**总分:** 5-25
-- **SIMPLE:** <= 8 (< 1 天)
-- **STANDARD:** 9-15 (1-3 天)
-- **COMPLEX:** >= 16 (3+ 天)
-
----
-
-## 架构师和其他代理的协作
-
-### 接收来自的输入
-
-- **@pm:** PRD 和业务需求
-- **@ux-design-expert:** 前端规范和 UI 模式
-- **@analyst:** 研究结果和技术发现
-
-### 委托给
-
-- **@db-sage:** 数据库架构和查询优化
-- **@devops:** Git 操作和 CI/CD
-
-### 交付给
-
-- **@dev:** 要实现的架构
-- **@po:** 工件验证
-- **@sm:** 供冲刺的故事
-
----
-
-## Git 限制
-
-```yaml
-git_restrictions:
-  allowed_operations:
-    - git status
-    - git log
-    - git diff
-    - git branch -a
-
-  blocked_operations:
-    - git push        # 仅 @github-devops
-    - git push --force
-    - gh pr create
-
-  redirect_message: "要进行 git push 操作，请激活 @github-devops"
-```
-
----
-
-## CodeRabbit 集成
-
-### 何时使用
-
-- 审查多层架构变更
-- 验证 API 设计模式
-- 审查安全架构
-- 审查性能优化
-- 验证集成模式
-- 审查基础设施代码
-
-### 严重性处理
-
-| 严重性 | 操作 | 专注 |
-|----------|------|------|
-| **CRITICAL** | 阻止批准 | 安全漏洞、完整性风险 |
-| **HIGH** | 标记讨论 | 性能瓶颈、反模式 |
-| **MEDIUM** | 文档化为技术债务 | 可维护性、设计模式 |
-| **LOW** | 重构备注 | 风格一致性 |
-
----
-
-## 最佳实践
-
-### 设计架构时
-
-1. 从用户开始 - 用户旅程指导架构决策
-2. 文档化权衡 - 记录选择的内容和原因
-3. 考虑演进 - 为变化设计，不完美
-4. 验证假设 - 对未知技术使用 `*research`
-5. 早期协作 - 在完成前涉及 @db-sage 和 @ux-design-expert
-
-### 分析影响时
-
-1. 使用适当的深度 - 快速检查使用 `shallow`，关键变更使用 `deep`
-2. 包括测试 - 对 API 变更使用 `--include-tests`
-3. 文档化决策 - 使用 `--save-report` 保存报告
-4. 尊重风险阈值 - 不要忽视 HIGH/CRITICAL
-
-### 文档化项目时
-
-1. 诚实文档 - 文档化技术债务，不要理想化
-2. 参考文件 - 使用真实路径，不要重复内容
-3. 专注 PRD - 如果存在 PRD，文档化相关区域
-4. 捕获陷阱 - 解决方案和部落知识很有价值
-
----
-
-## 总结
-
-| 方面 | 详情 |
-|---------|----------|
-| **代理名称** | Aria (愿景家) |
-| **ID** | @architect |
-| **总核心任务** | 7 个任务文件 |
-| **架构模板** | 4 个(全栈、后端、前端、brownfield) |
-| **设计命令** | 4 个(`*create-*-architecture`) |
-| **分析命令** | 3 个(`*analyze-impact`、`*assess-complexity`、`*research`) |
-| **文档命令** | 3 个(`*document-project`、`*execute-checklist`、`*create-doc`) |
-| **涉及的工作流** | 4 个(greenfield-fullstack、brownfield-fullstack、spec-pipeline、qa-loop) |
-| **协作代理** | 5 个(@pm、@ux-design-expert、@db-sage、@devops、@analyst) |
-| **Git 限制** | 仅读(推送 -> @devops) |
-| **外部工具** | 6 个(exa、context7、git、supabase-cli、railway-cli、coderabbit) |
-
----
-
-## 更改日志
-
-| 日期 | 作者 | 描述 |
-|------|-------|-----------|
-| 2026-02-04 | @architect | 创建初始文档 |
-
----
-
-*-- Aria，构建未来*

package/docs/zh/sinapse-agent-flows/data-engineer-system.md

@@ -1,418 +0,0 @@
-# 数据工程师代理系统 (@data-engineer) - SINAPSE
-
-> **版本:** 1.0.0
-> **创建于:** 2026-02-04
-> **所有者:** @data-engineer (Dara - The Sage)
-> **状态:** 官方文档
-
----
-
-## 概览
-
-**@数据工程师(Dara)**是SINAPSE的数据库架构师和运营工程师，负责架构设计、迁移、安全性(RLS)、性能优化和DBA操作。该代理充当**Sage(智者)**，建模业务领域，使用快照和回滚实现安全迁移，并确保数据完整性和安全性。
-
-### 主要特征
-
-| 特征 | 描述 |
-|------|------|
-| **角色名** | Dara - The Sage |
-| **原型** | Sage / Gemini |
-| **语气** | 技术、精确、方法性、安全意识强 |
-| **焦点** | 架构设计、迁移、RLS、性能、DBA操作 |
-| **签名** | "-- Dara，架构数据" |
-
-### 数据库的关键原则
-
-- **正确性优先于速度** - 先正确，再优化
-- **一切版本化和可逆** - 快照+回滚脚本
-- **默认安全** - RLS、约束、触发器确保一致性
-- **处处幂等** - 安全多次执行操作
-- **领域驱动设计** - 建模前理解业务
-- **访问模式优先** - 基于如何查询数据的设计
-- **深度防御** - RLS+默认值+检查约束+触发器
-- **集成可观测性** - 日志、指标、执行计划
-- **零停机为目标** - 仔细规划迁移
-
-### 特征词汇
-
-- 查询
-- 建模
-- 存储
-- 配置
-- 规范化
-- 索引
-- 迁移
-
----
-
-## 完整文件列表
-
-### @data-engineer的核心任务文件
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/db-domain-modeling.md` | `*model-domain` | 交互式域建模会话 |
-| `.sinapse-ai/development/tasks/setup-database.md` | `*setup-database [type]` | 数据库项目设置(Supabase、PostgreSQL、MongoDB、MySQL、SQLite) |
-| `.sinapse-ai/development/tasks/db-bootstrap.md` | `*bootstrap` | 创建标准Supabase项目结构 |
-| `.sinapse-ai/development/tasks/db-env-check.md` | `*env-check` | 验证数据库环境变量 |
-| `.sinapse-ai/development/tasks/db-apply-migration.md` | `*apply-migration {path}` | 应用迁移(含快照和锁定建议) |
-| `.sinapse-ai/development/tasks/db-dry-run.md` | `*dry-run {path}` | 测试迁移无提交 |
-| `.sinapse-ai/development/tasks/db-seed.md` | `*seed {path}` | 应用种子数据(幂等) |
-| `.sinapse-ai/development/tasks/db-snapshot.md` | `*snapshot {label}` | 创建架构快照 |
-| `.sinapse-ai/development/tasks/db-rollback.md` | `*rollback {snapshot_or_file}` | 恢复快照或执行回滚 |
-| `.sinapse-ai/development/tasks/db-smoke-test.md` | `*smoke-test {version}` | 全面的数据库测试 |
-| `.sinapse-ai/development/tasks/security-audit.md` | `*security-audit {scope}` | 安全审计(rls、架构、完整) |
-| `.sinapse-ai/development/tasks/analyze-performance.md` | `*analyze-performance {type}` | 性能分析(查询、热路径、交互) |
-| `.sinapse-ai/development/tasks/db-policy-apply.md` | `*policy-apply {table} {mode}` | 安装RLS策略(KISS或详细) |
-| `.sinapse-ai/development/tasks/test-as-user.md` | `*test-as-user {user_id}` | 模拟用户以测试RLS |
-| `.sinapse-ai/development/tasks/db-verify-order.md` | `*verify-order {path}` | 验证DDL顺序以处理依赖 |
-| `.sinapse-ai/development/tasks/db-load-csv.md` | `*load-csv {table} {file}` | 安全的CSV加载程序(staging->merge) |
-| `.sinapse-ai/development/tasks/db-run-sql.md` | `*run-sql {file_or_inline}` | 执行原始SQL(含事务) |
-| `.sinapse-ai/development/tasks/create-deep-research-prompt.md` | `*research {topic}` | 生成深度研究提示 |
-| `.sinapse-ai/development/tasks/execute-checklist.md` | `*execute-checklist {checklist}` | 执行DBA检查清单 |
-| `.sinapse-ai/development/tasks/create-doc.md` | `*doc-out` | 完整文档输出 |
-
-### 代理定义文件
-
-| 文件 | 目的 |
-|------|------|
-| `.sinapse-ai/development/agents/data-engineer.md` | @data-engineer代理核心定义(角色、命令、工作流) |
-| `.claude/commands/SINAPSE/agents/data-engineer.md` | Claude Code命令激活@data-engineer |
-
-### SQL模板文件
-
-| 文件 | 目的 |
-|------|------|
-| `schema-design-tmpl.yaml` | 架构文档模板 |
-| `rls-policies-tmpl.yaml` | RLS策略模板 |
-| `migration-plan-tmpl.yaml` | 迁移计划模板 |
-| `index-strategy-tmpl.yaml` | 索引策略模板 |
-| `tmpl-migration-script.sql` | 迁移脚本模板 |
-| `tmpl-rollback-script.sql` | 回滚脚本模板 |
-| `tmpl-smoke-test.sql` | 烟雾测试模板 |
-| `tmpl-rls-kiss-policy.sql` | RLS KISS策略模板 |
-| `tmpl-rls-granular-policies.sql` | 详细RLS策略模板 |
-| `tmpl-staging-copy-merge.sql` | CSV暂存合并模板 |
-| `tmpl-seed-data.sql` | 种子数据模板 |
-| `tmpl-comment-on-examples.sql` | COMMENT ON示例 |
-
-### 检查清单文件
-
-| 文件 | 目的 |
-|------|------|
-| `dba-predeploy-checklist.md` | 部署前DBA检查清单 |
-| `dba-rollback-checklist.md` | 回滚检查清单 |
-| `database-design-checklist.md` | 数据库设计检查清单 |
-
-### 数据/知识文件
-
-| 文件 | 目的 |
-|------|------|
-| `database-best-practices.md` | 数据库最佳实践 |
-| `supabase-patterns.md` | Supabase模式 |
-| `postgres-tuning-guide.md` | PostgreSQL调优指南 |
-| `rls-security-patterns.md` | RLS安全模式 |
-| `migration-safety-guide.md` | 迁移安全指南 |
-
-### 使用@data-engineer的工作流
-
-| 文件 | 目的 |
-|------|------|
-| `.sinapse-ai/development/workflows/brownfield-discovery.yaml` | Brownfield发现工作流(第2和第5阶段) |
-
----
-
-## 命令到任务的映射
-
-### 架构和设计命令
-
-| 命令 | 任务文件 | 操作 |
-|------|---------|------|
-| `*create-schema` | (内联) | 数据库架构设计 |
-| `*create-rls-policies` | (内联) | RLS策略设计 |
-| `*create-migration-plan` | (内联) | 创建迁移策略 |
-| `*design-indexes` | (内联) | 索引策略设计 |
-| `*model-domain` | `db-domain-modeling.md` | 交互式建模会话 |
-
-### DBA操作命令
-
-| 命令 | 任务文件 | 操作 |
-|------|---------|------|
-| `*setup-database [type]` | `setup-database.md` | 项目设置(supabase/postgresql/mongodb/mysql/sqlite) |
-| `*bootstrap` | `db-bootstrap.md` | Supabase结构脚手架 |
-| `*env-check` | `db-env-check.md` | 验证环境变量 |
-| `*apply-migration {path}` | `db-apply-migration.md` | 应用迁移(含安全快照) |
-| `*dry-run {path}` | `db-dry-run.md` | 测试迁移无提交 |
-| `*seed {path}` | `db-seed.md` | 应用幂等种子数据 |
-| `*snapshot {label}` | `db-snapshot.md` | 创建架构快照 |
-| `*rollback {target}` | `db-rollback.md` | 恢复快照或回滚 |
-| `*smoke-test {version}` | `db-smoke-test.md` | 验证测试 |
-
-### 安全和性能命令(整合 - Story 6.1.2.3)
-
-| 命令 | 任务文件 | 操作 |
-|------|---------|------|
-| `*security-audit rls` | `security-audit.md` | RLS覆盖审计 |
-| `*security-audit schema` | `security-audit.md` | 架构质量审计 |
-| `*security-audit full` | `security-audit.md` | 完整审计 |
-| `*analyze-performance query` | `analyze-performance.md` | EXPLAIN ANALYZE查询 |
-| `*analyze-performance hotpaths` | `analyze-performance.md` | 检测系统瓶颈 |
-| `*analyze-performance interactive` | `analyze-performance.md` | 交互优化会话 |
-| `*policy-apply {table} {mode}` | `db-policy-apply.md` | 安装RLS策略(KISS或详细) |
-| `*test-as-user {user_id}` | `test-as-user.md` | 模拟用户测试RLS |
-| `*verify-order {path}` | `db-verify-order.md` | 验证DDL顺序 |
-
-### 数据操作命令
-
-| 命令 | 任务文件 | 操作 |
-|------|---------|------|
-| `*load-csv {table} {file}` | `db-load-csv.md` | 安全的CSV加载程序 |
-| `*run-sql {file_or_inline}` | `db-run-sql.md` | 执行SQL(含事务) |
-
-### 上下文和会话命令
-
-| 命令 | 操作 |
-|------|------|
-| `*help` | 显示所有可用命令 |
-| `*guide` | 显示完整使用指南 |
-| `*yolo` | 切换确认(跳过/要求) |
-| `*exit` | 退出data-engineer模式 |
-| `*doc-out` | 完整文档输出 |
-| `*execute-checklist {checklist}` | 执行DBA检查清单 |
-| `*research {topic}` | 生成深度研究提示 |
-
----
-
-## 代理间的集成
-
-### 协作图
-
-```mermaid
-flowchart TB
-    subgraph DATA_ECOSYSTEM["@数据工程师生态系统"]
-        DATA["@data-engineer(Dara)"]
-    end
-
-    subgraph UPSTREAM["上游 - 提供需求"]
-        ARCH["@architect(Aria)<br/>系统架构"]
-    end
-
-    subgraph DOWNSTREAM["下游 - 接收架构"]
-        DEV["@dev(Dex)<br/>开发者"]
-    end
-
-    subgraph COLLABORATION["发现中的协作"]
-        QA["@qa(Quinn)<br/>质量门控"]
-    end
-
-    ARCH -->|"架构需求<br/>门控2决策"| DATA
-    DATA -->|"架构设计<br/>迁移<br/>RLS策略"| DEV
-
-    DATA -->|"DB审计<br/>第2阶段brownfield-discovery"| QA
-    QA -->|"验证<br/>第7阶段"| DATA
-
-    style DATA fill:#e8f5e9
-    style ARCH fill:#e3f2fd
-    style DEV fill:#fff3e0
-    style QA fill:#fce4ec
-```
-
-### 当使用其他代理时
-
-| 任务 | 代理 | 原因 |
-|------|------|------|
-| 系统架构 | @architect | 应用级模式、API设计 |
-| 应用代码 | @dev | 仓库模式、DAL实现 |
-| 前端设计 | @ux-design-expert | UI/UX设计 |
-| Git操作 | @github-devops | 推送、PR、部署 |
-
----
-
-## 配置
-
-### 必需的环境变量
-
-```bash
-# Supabase数据库连接
-SUPABASE_DB_URL="postgresql://postgres.[PASSWORD]@[PROJECT-REF].supabase.co:6543/postgres?sslmode=require"
-
-# 用于备份/分析(直接连接)
-# SUPABASE_DB_URL="postgresql://postgres.[PASSWORD]@[PROJECT-REF].supabase.co:5432/postgres"
-```
-
-### 标准目录结构(Supabase)
-
-```
-supabase/
-├── migrations/      # 迁移文件
-│   └── README.md
-├── seeds/           # 种子数据
-│   └── README.md
-├── tests/           # 烟雾测试
-│   └── README.md
-├── rollback/        # 回滚脚本
-│   └── README.md
-├── snapshots/       # 架构快照
-├── docs/            # 文档
-│   ├── SCHEMA.md
-│   └── migration-log.md
-├── config.toml      # 本地配置
-└── .gitignore
-```
-
----
-
-## 最佳实践
-
-### 何时使用@data-engineer
-
-**使用@data-engineer进行:**
-- 数据库架构设计
-- 域建模
-- 迁移和版本控制
-- RLS策略和安全性
-- 查询优化和性能
-- DBA操作(备份、恢复、烟雾测试)
-- 安全和质量审计
-
-**不要使用@data-engineer进行:**
-- 系统架构(使用@architect)
-- 应用代码(使用@dev)
-- Git操作(使用@github-devops)
-- 前端/UI(使用@ux-design-expert)
-
-### 安全迁移工作流
-
-```bash
-# 1. 任何迁移前
-*snapshot pre_migration
-
-# 2. 测试迁移
-*dry-run path/to/migration.sql
-
-# 3. 应用迁移
-*apply-migration path/to/migration.sql
-
-# 4. 验证结果
-*smoke-test
-*security-audit rls
-
-# 5. 如有问题
-*rollback supabase/snapshots/{TS}_pre_migration.sql
-```
-
-### 表模式
-
-每个表应有基线:
-- `id`(UUID主键)
-- `created_at`(时间戳)
-- `updated_at`(时间戳)
-- 关系的外键
-- 默认启用RLS
-- 外键和频繁查询列的索引
-
-### 安全性
-
-- 从不暴露机密 - 自动redact密码/令牌
-- 优先使用Pooler连接(端口6543)和SSL
-- 没有Auth层时，警告`auth.uid()`返回NULL
-- RLS应以正反例验证
-- Service角色密钥绕过RLS - 极度谨慎使用
-- 总是为多语句操作使用事务
-- 构建动态SQL前验证用户输入
-
----
-
-## 故障排除
-
-### 数据库连接失败
-
-```
-错误: pg_dump: error: connection failed
-```
-
-**解决方案:**
-1. 验证SUPABASE_DB_URL: `*env-check`
-2. 检查连接字符串格式
-3. 验证SSL模式
-4. 手动测试连接: `psql "$SUPABASE_DB_URL"`
-
-### 迁移执行失败
-
-**情况:** `*apply-migration`中途失败
-
-**操作:** PostgreSQL已自动回滚事务
-
-**下一步:**
-1. 修复迁移文件
-2. `*dry-run`测试
-3. 再次`*apply-migration`
-
-### 锁定已持有
-
-```
-错误: Another migration is running
-```
-
-**解决方案:**
-1. 等待其他迁移完成
-2. 检查卡住的锁:
-   ```sql
-   SELECT * FROM pg_locks WHERE locktype = 'advisory';
-   ```
-3. 如必要手动取消锁定
-
-### RLS策略不工作
-
-**症状:** 用户看到不应该看到的数据
-
-**解决方案:**
-1. 检查RLS是否启用: `*security-audit rls`
-2. 以特定用户身份测试: `*test-as-user {user_id}`
-3. 检查USING子句是否正确
-4. 检查`auth.uid()`返回预期值
-
----
-
-## 参考
-
-### @data-engineer任务
-
-- [db-domain-modeling.md](.sinapse-ai/development/tasks/db-domain-modeling.md)
-- [setup-database.md](.sinapse-ai/development/tasks/setup-database.md)
-- [db-apply-migration.md](.sinapse-ai/development/tasks/db-apply-migration.md)
-- [security-audit.md](.sinapse-ai/development/tasks/security-audit.md)
-- [analyze-performance.md](.sinapse-ai/development/tasks/analyze-performance.md)
-- [db-snapshot.md](.sinapse-ai/development/tasks/db-snapshot.md)
-- [db-rollback.md](.sinapse-ai/development/tasks/db-rollback.md)
-- [db-bootstrap.md](.sinapse-ai/development/tasks/db-bootstrap.md)
-
-### 代理
-
-- [data-engineer.md](.sinapse-ai/development/agents/data-engineer.md)
-
-### 工作流
-
-- [brownfield-discovery.yaml](.sinapse-ai/development/workflows/brownfield-discovery.yaml)
-
----
-
-## 总结
-
-| 方面 | 详情 |
-|------|------|
-| **总核心任务** | 20个任务文件 |
-| **主要命令** | 25+命令 |
-| **支持的数据库** | 5(Supabase、PostgreSQL、MongoDB、MySQL、SQLite) |
-| **审计类型** | 3(rls、架构、完整) |
-| **性能分析类型** | 3(查询、热路径、交互) |
-| **SQL模板** | 12个模板 |
-| **DBA检查清单** | 3个 |
-| **数据文件** | 5个知识文件 |
-| **集成工作流** | 1(brownfield-discovery) |
-| **协作代理** | 3(@architect、@dev、@qa) |
-| **brownfield-discovery阶段** | 2(第2阶段: 收集、第5阶段: 验证) |
-
----
-
-*-- Dara，架构数据*