@squadbase/vantage 0.7.0-stg.18ca87d → 0.7.1-dev1.01a6413

package/docs/ja/agent-skills.md

@@ -1,6 +1,6 @@
 # エージェントと Skills
 
-> Vantage に同梱された Claude Code の Agent Skills。vantage add skill でアプリに配置し（既定はルート直下、--dir で .claude/skills などに変更）、エージェントに手順を伴うワークフローを教える。
+> Vantage に同梱された Claude Code の Agent Skills。vantage add skill でアプリに配置し（既定は .squadbase/ があれば .squadbase/skills、無ければ配置済みの Skill と同じ場所、それも無ければルート直下。--dir で変更）、エージェントに手順を伴うワークフローを教える。
 
 Vantage は **Claude Code の Agent Skills** を同梱しています。Skill は「手順を伴うワークフロー」を、
 エージェントが必要なときだけ呼び出せる形にしたものです。UI キットや CLI の使い方といった
@@ -22,13 +22,13 @@ Vantage は **Claude Code の Agent Skills** を同梱しています。Skill
 ## 配置する
 
 Skill のソースは `@squadbase/vantage` パッケージに同梱されています。`vantage add skill` で
-対象アプリにコピーします。配置先は既定で**プロジェクトルート直下**で、`--dir` で変えられます。
+対象アプリにコピーします。配置先は既定で、`.squadbase/` があるプロジェクトでは **`.squadbase/skills/`**、無ければ**配置済みの Skill と同じディレクトリ**（1 つも無ければプロジェクトルート直下）で、`--dir` で変えられます。
 
 ```bash
 vantage add skill                             # 一覧と配置場所を表示するだけ(何も書かない)
-vantage add skill --all                       # 未配置のものを、ルート直下に配置
+vantage add skill --all                       # 未配置のものを、既定の場所(.squadbase/skills など)に配置
 vantage add skill vantage-app                 # 名前を指定して1つだけ配置
-vantage add skill --all --dir .claude/skills  # Claude Code が読む場所に配置
+vantage add skill --all --dir .claude/skills  # 置き場所を指定
 vantage add skill --all --force               # 配置済みのコピーをその場で最新に更新
 ```
 
@@ -40,9 +40,9 @@ vantage add skill --all --force               # 配置済みのコピーをそ
 ```text
 $ vantage add skill
 Bundled skills:
-  project-storage      .claude/skills/project-storage/
-  vantage-add-feature  .claude/skills/vantage-add-feature/
-  vantage-app          .claude/skills/vantage-app/
+  project-storage      .squadbase/skills/project-storage/
+  vantage-add-feature  .squadbase/skills/vantage-add-feature/
+  vantage-app          .squadbase/skills/vantage-app/
   vantage-design       not placed
   vantage-pitfalls     not placed
   vantage-slide        not placed
@@ -51,14 +51,14 @@ Bundled skills:
 `--force` を付けると、**見つかった場所をそのまま**新しい内容で書き換えます(`--dir` を明示した
 ときは、そちらが配置先として優先されます)。
 
-`--dir` のパスはプロジェクトルートからの相対で解決されます（絶対パスも可）。Claude Code に
-自動認識させるなら `.claude/skills/` に置きます:
+`--dir` のパスはプロジェクトルートからの相対で解決されます（絶対パスも可）。
+Squadbase のプロジェクトでは `.squadbase/skills/` に置きます:
 
 ```text
 your-app/
 ├── index.tsx
 ├── package.json
-└── .claude/
+└── .squadbase/
     └── skills/
         ├── vantage-app/SKILL.md
         ├── vantage-add-feature/SKILL.md
@@ -68,12 +68,12 @@ your-app/
         └── project-storage/SKILL.md
 ```
 
-`.claude/skills/` は Claude Code が自動で認識します。エージェントはタスクに応じて、対応する
-Skill の手順を読み込んで実行します。他のエージェントに読ませる場合は、そのツールが期待する
+Squadbase のエージェントは `.squadbase/skills/` の Skill を読み、タスクに応じて対応する
+手順を実行します。Claude Code 単体で使うなら `--dir .claude/skills` を渡してください(`.claude/skills/` は Claude Code が自動で認識します)。他のエージェントに読ませる場合は、そのツールが期待する
 ディレクトリを `--dir` に渡してください。
 
 > [!NOTE]
-> `.claude/` はツール用の設定であり、アプリのコードではありません。`vantage check` の静的診断は
+> `.squadbase/` はツール用の設定であり、アプリのコードではありません。`vantage check` の静的診断は
 > このディレクトリを走査しないため、置いてもビルドや検査には影響しません。
 
 ## 配布と更新の方針
@@ -83,7 +83,7 @@ Skill の手順を読み込んで実行します。他のエージェントに
   コピーを更新したいときは `vantage add skill --all --force` を実行します(置き場所は走査して
   見つけるので、`--dir` を覚えておく必要はありません)。
 - **Squadbase テンプレートには配置済み**です。テンプレートから作ったアプリには、最初から
-  `.claude/skills/` が入っています。手で作ったアプリには `vantage add skill` で足してください。
+  `.squadbase/skills/` が入っています。手で作ったアプリには `vantage add skill` で足してください。
 
 ## `AGENTS.md` + `agents/*.md`(アプリの地図と知識ファイル)
 

package/docs/ja/changelog.md

@@ -8,6 +8,14 @@ Vantage のリリースごとの変更点です。新しいものが上に来ま
 > まだプロトタイプ(**0.x**)です。0.x の間は **minor が実質のメジャー**扱いで、後方互換性の
 > ない変更は minor で入ることがあります。patch は後方互換の機能追加とバグ修正のみです。
 
+## v0.7.1
+
+`vantage add skill` の新規配置の既定を、`readSkill` が読む `.squadbase/skills/` を優先し、無ければ配置済みの Skill と同じディレクトリにしました。
+
+- `.squadbase/` があるプロジェクトでは、Skill が 1 つも無くても `.squadbase/skills/` に入ります。
+- `.squadbase/` が無いプロジェクトで、Skill が置かれているとき、`vantage add skill <name>` や `--all --force` で増えた Skill が、ルート直下ではなく同じディレクトリに入ります。複数のディレクトリに分かれているときは、配置済みの Skill が最も多いディレクトリ(同数なら辞書順の先頭)です。
+- Skill が 1 つも無いとき(ルート直下)と `--dir` 指定の動きは変わりません。
+
 ## v0.7.0
 
 UI 部品とテーマを作り直し、KPI・チャート・スライド / ドキュメント向けの部品が大きく増えました。

package/docs/ja/parts/draft-chart.md

@@ -0,0 +1,40 @@
+# DraftChart
+
+> まだ採用されていないグラフの提案を囲む。開発サーバーでは薄く表示し、ビルドには出さない。
+
+ページに提案として足したグラフのうち、まだ採用されていないものを囲みます。囲むのはカード 1 枚です。
+採用するまで、公開したダッシュボードの閲覧者には見えません。
+
+```tsx
+import { DashboardCardPreset, DraftChart } from "@squadbase/vantage/components";
+import type { DraftChartProps } from "@squadbase/vantage/components";
+```
+
+```tsx
+<div className="grid gap-4 md:grid-cols-2">
+  <DraftChart>
+    <DashboardCardPreset data-sq-ref="campaign-roas" title="キャンペーン別 ROAS">
+      <BarChart data={rows} index="campaign" categories={["roas"]} />
+    </DashboardCardPreset>
+  </DraftChart>
+</div>
+```
+
+| Prop | Type | 説明 |
+| --- | --- | --- |
+| `children` | `ReactElement` | 提案するカード 1 枚。 |
+
+## 表示
+
+- **`vantage dev`**: カードの上にページの背景色（`--background`）を 75% の濃さで重ね、薄く見せます。
+  ポインタを載せている間は重ねた色が 200ms で消え、グラフを読めます。重ねた色はクリックやホバーを
+  妨げません。`prefers-reduced-motion` が有効なら切り替えにアニメーションを付けません。
+- **`vantage build`**: 何も描きません（中のカードもマウントしません）。
+
+`DraftChart` 自身は箱を持ちません（`display: contents`）。中のカードは親の grid の直接の子のままなので、
+`col-span-*` や subgrid の行の揃い方は `DraftChart` が無いときと変わりません。ボタンや文言も出しません。
+
+## 採用と取り下げ
+
+採用するときは `<DraftChart>` と `</DraftChart>` のタグだけを消し、中のカードを残します。取り下げるときは
+`<DraftChart>…</DraftChart>` を丸ごと消します。

package/docs/ja/parts/page-shell.md

@@ -26,7 +26,7 @@ import {
 
 | パーツ | 役割 |
 | --- | --- |
-| `PageShell` | 全体の縦積み |
+| `PageShell` | 全体の縦積み。`title`（と `description`）を渡すと、見出しのヘッダーと本文（`PageShellContent`）を組んで `children` を本文に入れる。渡さなければ薄い `<div>` のまま |
 | `PageShellHeader` | 下線付きのヘッダー帯。左に見出し、右に `HeaderEnd`。幅が足りないと `HeaderEnd` は見出しの下へ回り込む |
 | `PageShellHeading` / `PageShellTitle` / `PageShellDescription` | 見出しブロック |
 | `PageShellHeaderEnd` | 右端の縦積み |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squadbase/vantage",
-  "version": "0.7.0-stg.18ca87d",
+  "version": "0.7.1-dev1.01a6413",
   "description": "Data dashboard framework for Squadbase Editor. Vite-powered, config-free, one-file first.",
   "type": "module",
   "license": "MIT",
@@ -152,7 +152,7 @@
     "vitest": "^5.0.5",
     "@squadbase/squadkit": "0.0.0"
   },
-  "gitHead": "18ca87d962d472e180c00dbd81a41a0ea213eab3",
+  "gitHead": "01a6413cae8e306d317219583aeca54b09ff1576",
   "scripts": {
     "build": "node scripts/build-docs.mjs && node scripts/build.mjs",
     "build:js": "tsup --no-dts",