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

idempotent な consumer(2 回実行しても壊れない)。決定的な replay が同じ状態を再構築し、副作用は idempotency-key で重複排除。

悪いデータは downstream を汚染しない

境界で検証。落ちたものは理由と出所を付けて隔離/DLQ へ — 良いデータセットには決して入らず、黙って消えない。

可逆な expand-contract migration

expand → migrate → contract、各ステップに検証済みの down。1 ステップでの破壊的な 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 で確認。

インストールしたくない?

完全な規約を読み、そのままプロジェクトにコピーできます。あるいはスキルをインストールすれば、エージェントが自動で適用します。