specsfy-aux-database について
specsfy-aux-databaseは、プロジェクトのデータマップを保守するエージェントスキルです。スキーマ、マイグレーション、永続モデル、設定を調べてDATABASE.mdを更新し、不明点は推測せず未知として記録します。
主な機能
- 01スキーマとマイグレーションの調査
- 02DATABASE.mdのインベントリ更新
- 03関係と制約の記録
- 04管理対象外の内容を保持
- 05秘密情報や本番データの転記を回避
活用シーン
- 01スキーマ変更後のデータマップ更新
- 02文書とソースの構造の照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ promovaweb/ specsfy --skill specsfy-aux-databaseインストール後、Claude Code で/specsfy-aux-databaseを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlscripts/update_database.mjs
詳細
データマップを維持する
必須の準備
このスキルを実行する前に、プロジェクトのルートで $specsfy-setup を必ず読み込んでください。自動ハンドオフの場合は、この手順の前に再度読み込んでください。
会話で確認済みのルートを再利用し、セットアップで未解決事項が示された場合は先に進まないでください。
対話モード
対話モード:質問なし。
このスキルでは質問しないでください。確認済みの情報が不足している場合は、担当する対話ステップに向けて未解決のフィールドを示してください。
- ローカルの指示、
PROJECT.md、STACK.md、およびDATABASE.md全体を読みます。 - 環境値や認証情報を明かさずに、スキーマ、マイグレーション、永続化モデル、設定を調査します。
node scripts/update_database.mjs --project <raiz>を実行します。- 検出されたインベントリを実行可能なソースと照合します。
- 安全に推測できないリレーション、インデックス、制約、所有権、保持期間、用途を補完します。不明なものは作り上げず、不明として記載してください。
specsfy:databaseブロック外のすべての内容を保持します。DATABASE.mdに新しい構造が反映され、関連するテストが成功するまで、データ変更は未完了として扱います。- ハンドオフを返す前に、監視モードで
$specsfy-setupを実行し、.specsfy/DATABASE.mdが未解決事項として表示されなくなることを確認します。
$specsfy-data-discovery によって確認済みの回答が記録されている場合は、確認済みの保存情報 セクションを保持し、コードから判明した内容と照合してください。会話では製品について説明し、このマップには実装済みの内容も引き続き示します。
検索と比較ができるよう、Markdown テーブルを使用してください。本番データ、接続文字列、パスワード、トークン、.env の値は決してコピーしないでください。
コメント
Markdown 対応