메뉴
anytime-markdown（trail.db / trail-core）固有の SQLite テーブル定義の補足。スキーマ配置パス・マイグレーションスクリプト規約・本番 DB 運用を定義する。汎用 SQLite 規約（STRICT / CHECK / FK ON DELETE / 12-step migration）は global スキル `sqlite-table-definition` に集約。trail-core のテーブル・制約・インデックス・マイグレーションを追加/変更する時に使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
/Shared/anytime-markdown-docs 配下のドキュメントを新規作成・執筆する時に、type（spec/tech/test/manual/proposal/plan/review/report）ごとの記載内容（何を書くか）・フォルダ構成・索引 index.[lang].md の自動生成運用を定義する。設計書（spec）の書き方・component spec の 2 ファイル分離・E2E シナリオ表・技術解説記事（tech。「技術記事を書いて」「ブログ記事を作成」「解説記事を書いて」等）の構成テンプレート・執筆ガイドライン・文体・生成ワークフロー・試験設計書（「試験設計書」「テスト設計書」「テストケースを設計」「テスト観点で洗い出し」「テスト計画」「QA 設計」等。7 ペルソナ観点・技法・自動化判定）・プランファイルの「変更対象ファイル」節・索引再生成が必要な時に使用する。構文・フロントマター・整形は anytime-markdown-output、既存設計書の読み方・辿り方は anytime-spec-lookup を使う。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。
anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。
| name | sqlite-table-definition-trail-core |
| effort | low |
| description | anytime-markdown（trail.db / trail-core）固有の SQLite テーブル定義の補足。スキーマ配置パス・マイグレーションスクリプト規約・本番 DB 運用を定義する。汎用 SQLite 規約（STRICT / CHECK / FK ON DELETE / 12-step migration）は global スキル `sqlite-table-definition` に集約。trail-core のテーブル・制約・インデックス・マイグレーションを追加/変更する時に使用する。 |
更新日: 2026-06-20
anytime-markdown の SQLite 永続化（主に trail.db）でテーブルを定義・変更する際のプロジェクト固有の補足。
STRICT・CHECK・FK ON DELETE・timestamp GLOB・インデックス命名・12-step テーブル再作成といった汎用ルールは global スキル sqlite-table-definition に集約しているため、本スキルと併用すること。
[!IMPORTANT] 汎用 SQLite 規約は global
~/.claude/skills/sqlite-table-definition/SKILL.mdを参照。本スキルは trail-core 固有の配置・運用差分のみを定義する。
| 対象 | 場所 |
|---|---|
| 新規テーブル定義 | packages/trail-core/src/domain/schema/tables.ts への CREATE TABLE 追加 |
| マイグレーションスクリプト | scripts/migrate-*.mts（tables.ts から DDL を直接 import） |
| 既存 DB へのインデックス追加 | 初期化処理に CREATE INDEX IF NOT EXISTS を追加（次回起動時に冪等適用。VS Code 拡張ではユーザーの Extension Host 再起動が必要） |
.mts で書く: tables.ts の DDL を import して drift を防ぐ。.mjs での DDL inline 複製は禁止。実行は node --experimental-strip-types scripts/migrate-<topic>.mts <db-path>。trail.db への適用: 直接実行せず、cp でコピー → 動作確認（integrity_check / foreign_key_check / row counts）→ VACUUM → 原子的 swap（*.before-X-YYYYMMDD でバックアップ）の順。詳細手順は global スキル §9.6 を参照。ALTER TABLE / 12-step migration を使う（Supabase の洗い替え方式とは異なる。code-quality.md §21 参照）。sql.js（WASM SQLite）のクエリ設計: trail-viewer 等の sql.js 経由クエリは CTE + window 関数 + 非等値 JOIN + GROUP BY の組み合わせで性能崩壊する。シンプル範囲スキャン + JS 側集計に分解する（code-quality.md §16 参照）。sqlite-table-definition — 汎用 SQLite テーブル定義ルール（本スキルの前提）code-quality.md §15（日時データの UTC 統一）・§16（sql.js クエリ設計）・§21（Supabase スキーマ運用）