kc-connect-data について
kc-connect-dataは、既存プロジェクトに永続データを設計・接続するためのSkillです。データフローを構築する開発者向けに、既存の慣例、アクセス境界、再現可能なスキーマ変更、必要な検証を重視します。
主な機能
- 01データ対象・フィールド・関係を把握
- 02既存プロバイダーと移行方法に従う
- 03秘密情報と管理権限をクライアントから分離
- 04アクセス方針と影響の大きい変更を確認
- 05スキーマ変更を記録し読み書きを検証
活用シーン
- 01プロジェクトの永続データ構造を設計
- 02既存プロバイダー経由でデータを接続
- 03クライアントとサーバーの権限境界を確認
- 04移行・入力検証・アクセス拒否を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ taehalim/ kc-skills --skill kc-connect-dataインストール後、Claude Code で/kc-connect-dataを入力して読み込まれたか確認します。
同梱ファイルreferences/access-patterns.mdreferences/data-contract.md
README(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
영구 데이터 연결하기
현재 프로젝트의 데이터 공급자와 관례를 우선하고 특정 서비스나 프레임워크를 기본값으로 가정하지 않는다.
진행
- 현재 프로젝트에서 저장할 업무 객체, 필요한 필드, 관계, 보관 기간과 접근 주체를 파악한다.
- 핵심 흐름을 지원하는 최소 구조를 설계한다. 소유권과 접근 범위가 불명확하면 데이터 계약을 참고한다.
- 기존 데이터 공급자, 마이그레이션 방식, 환경변수 규칙과 접근 정책을 따른다. 외부 클라우드 사용이 제한되거나 불명확하면 외부 데이터 프로젝트를 만들지 않고 로컬 또는 승인된 저장 방식으로 범위를 조정한다.
- 사용자 클라이언트에는 공개 가능한 자격증명과 허용된 작업만 둔다. 비밀값과 관리자 권한은 클라이언트 밖의 신뢰 경계에서 처리하고, 업무 규칙과 권한 검사는 우회할 수 없는 계층에 둔다.
- 접근 구조를 결정할 때 필요하면 접근 방식을 참고한다. 명시적으로 공개하기로 정한 정보가 아니라면 운영 화면이나 전체 기록을 인증 없이 공개하지 않는다.
- 클라우드 프로젝트 생성, 운영 데이터 변경, 접근 정책 변경 또는 되돌리기 어려운 마이그레이션 전에는 대상·영향·복구 방법을 확인한다. 이미 명시적으로 승인된 같은 작업을 반복 확인하지 않는다.
- 스키마 변경은 프로젝트 관례에 맞는 재현 가능한 기록으로 남긴다.
- 실제 자료 없이 흐름을 확인해야 할 때만 안전한 가상 데이터를 사용한다.
- 변경과 관련된 읽기·쓰기, 입력 검증과 접근 거부를 필요한 범위에서 확인한다.
- 비밀값, 환경 파일, 공급자 캐시와 실제 개인정보가 저장소나 로그에 포함되지 않았는지 확인한다.
완료
업무 언어로 데이터 구조, 접근 경계, 변경 기록, 실제 확인 결과와 남은 위험을 보고한다.
コメント
Markdown 対応