Skills · Claude Code · Agent Skills
数据即契约——不容妥协。
数据是契约而非副作用:breaking change 必须发新版本,通过 Outbox 交付,安全的 idempotency 与 replay,坏数据进隔离区,访问 deny-by-default。
schematize-data · v0.1.0bash
$ schematize install data不可妥协的底线
绝不为“求快”而关闭。完整清单见技能。
数据即契约
每一份跨越边界的数据都有版本化 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 确认。
讨论
加载中…