Skills · Claude Code · Agent Skills

数据即契约——不容妥协。

数据是契约而非副作用:breaking change 必须发新版本,通过 Outbox 交付,安全的 idempotency 与 replay,坏数据进隔离区,访问 deny-by-default。

v0.1.0Disciplina · Dadosgithub.com/schematizeme/skill-data

维护者 Lucas Andrade

schematize-data · v0.1.0bash
$ schematize install data
GitHub →下载技能 (.zip)/data-help · github.com/schematizeme/schematize-cli

不可妥协的底线

绝不为“求快”而关闭。完整清单见技能。

数据即契约

每一份跨越边界的数据都有版本化 schema。删除/重命名/改类型都是破坏性变更:必须发 v2 并留出有文档的共存窗口。

通过 Outbox 交付

Transactional Outbox(或来自数据库日志的 CDC);禁止 dual-write。每个 consumer 都有 DLQ;retry 有限并带 backoff,绝不无限。

安全的 idempotency 与 replay

consumer 幂等(跑两次不会损坏);确定性 replay 重建相同状态;副作用按 idempotency-key 去重。

坏数据不污染下游

在边界校验;未通过的带上原因和来源进隔离区/DLQ——绝不进入好数据集,绝不悄悄消失。

可逆的 expand-contract migration

expand → migrate → contract,每一步都有经测试的 down。禁止在单步内做破坏性的 DROP/rename。Timestamp 用 UTC,ID 用 UUIDv7/ULID。

Deny-by-default + 受治理的 PII

默认拒绝访问,按 tenant 在服务端;SQL 参数化。PII 仅在有合法依据 + retention 时使用,且不入 log/URL。lineage 可追溯;始终 archive。

命令

安装在 .claude/commands/。随时运行 /data-help。

/data-help列出所有命令。
/data-contract定义/审计数据契约:版本化 schema、兼容性(back/forward/full)、registry、演进策略;拦截没有新版本的 breaking change。
/data-pipeline设计/审计管道(ETL/ELT 批处理、streaming、CDC/event sourcing):idempotency、通过 Outbox 交付、replay、backpressure、DLQ。
/data-quality搭建/审计质量门禁:边界校验、数据测试/expectations、隔离区与 dead-letter、数据 SLA。
/data-load强制加载全部规范:契约、管道、质量、存储、治理。
/data-claude在仓库根目录创建或合并常开的数据 CLAUDE.md。
/data-ccContext compact:将 handoff 写入归档并运行 /compact。
/data-handoff生成 handoff(context.md + checklist.md)而不压缩。

面向 AI 智能体

无需人工即可安装。元数据见 llms.txt。

  • 运行:git clone https://github.com/schematizeme/skill-data.git && ./skill-data/install.sh
  • 或下载:https://github.com/schematizeme/skill-data/releases/latest/download/skill-data.zip 并解压到 .claude/skills/
  • 将 assets/CLAUDE.md 复制到仓库根目录(常开规则)。
  • 用 /data-help 确认。

不想安装?

阅读完整规范并直接复制到你的项目——或安装该技能,让智能体自动执行。