⚡

EmpathyLedger开发技能Skill empathy-ledger-dev

Empathy Ledger开发技能是一个专门用于指导Empathy Ledger v2平台开发的综合参考工具。该平台是一个面向原住民社区、内置文化安全协议的多租户故事讲述系统。本技能提供项目结构、核心概念（如OCAP原则、文化敏感性分级）、常见开发模式、数据库设计、核心服务等快速参考。适用于开发人员快速查阅项目规范、确保文化合规性、实现多租户隔离、管理故事所有权和数据主权。关键词：Empathy Ledger、原住民数据主权、OCAP原则、文化安全协议、多租户架构、故事讲述平台、React开发、Next.js、Supabase、GDPR合规、文化敏感性设计。

前端开发 0 次安装 6 次浏览 更新于 3/1/2026

name: empathy-ledger-dev description: “在以下情况调用此技能：- 开始开发任何Empathy Ledger功能时 - 需要快速参考项目模式时”

Empathy Ledger 开发技能

此技能为开发Empathy Ledger v2平台提供全面的上下文信息——这是一个具有文化安全协议的原住民社区多租户故事讲述平台。

快速参考

项目结构

src/
├── app/                    # Next.js 15 App Router
│   ├── api/               # API路由
│   ├── vault/             # 故事库仪表板
│   └── stories/           # 故事页面
├── components/            # React组件
│   ├── ui/               # shadcn/ui基础组件
│   ├── vault/            # 故事库组件
│   └── cultural/         # 文化协议UI组件
├── lib/                   # 工具和服务
│   ├── services/         # 业务逻辑服务
│   ├── hooks/            # React钩子
│   └── ai/               # AI集成
└── types/                # TypeScript类型
    └── database/         # 按领域划分的Supabase类型

核心概念

OCAP原则（原住民数据主权）：

  • 所有权：故事讲述者拥有自己的叙事
  • 控制权：用户控制谁可以访问他们的故事
  • 访问权：基于文化敏感性的分级访问
  • 占有权：数据可随时导出/删除

多租户架构：

  • 所有表都有tenant_id用于隔离
  • RLS策略强制执行租户边界
  • 组织 = 租户

文化敏感性级别：

  • standard - 允许一般分享
  • medium - 需要社区上下文
  • high - 建议长者审核
  • sacred - 必须获得长者批准，禁止外部分享

常见模式

API路由认证：

const supabase = createRouteHandlerClient({ cookies })
const { data: { user }, error } = await supabase.auth.getUser()
if (error || !user) {
  return NextResponse.json({ error: '未授权' }, { status: 401 })
}

故事所有权检查：

const isOwner = story.author_id === user.id || story.storyteller_id === user.id

文化色彩调色板：

  • clay-* - 主要色，故事讲述者元素
  • sage-* - 社区色，长者批准
  • sky-* - 组织色，信任
  • ember-* - 警告色，敏感性

数据库领域

领域 文件 内容
用户/个人资料 user-profile.ts 个人资料、偏好设置
组织 organization-tenant.ts 租户、成员资格
项目 project-management.ts 项目、里程碑
内容 content-media.ts 故事、媒体
文化 cultural-protocols.ts 敏感性、审批
法律 consent-legal.ts 同意、GDPR
故事所有权 story-ownership.ts 分发、嵌入

核心服务

  • EmbedService - 管理具有域名限制的故事嵌入
  • DistributionService - 跟踪外部分享
  • RevocationService - 级联撤销
  • GDPRService - 匿名化、数据导出
  • AuditService - 操作日志记录

斜杠命令

  • /design-component [描述] - 创建React组件
  • /database-migration [描述] - 创建Supabase迁移
  • /review-cultural [代码/功能] - 文化敏感性审查
  • /review-security [代码/端点] - 安全审计
  • /generate-e2e-test [功能] - 创建Playwright测试
  • /api-endpoint [描述] - 创建API路由

专业代理

  • frontend-designer - 具有文化设计的UI/UX
  • database-architect - Supabase/PostgreSQL
  • cultural-reviewer - OCAP合规性
  • security-auditor - GDPR和安全性
  • testing-automation - Playwright端到端测试

何时使用此技能

在以下情况调用此技能：

  • 开始开发任何Empathy Ledger功能时
  • 需要快速参考项目模式时
  • 审查代码合规性时
  • 创建新组件/端点时

参考文件

以下文件提供详细上下文：

  • CLAUDE.md - 项目说明
  • .claude/agents/*.md - 专业代理提示
  • .claude/commands/*.md - 斜杠命令定义
  • src/types/database/ - 数据库类型定义