菜单
survey-any の Astro viewer (viewer/) をローカルでビルドし、Cloudflare Pages 互換のサーバ (wrangler pages dev + D1 + Functions) を起動してブラウザ確認するスキル。 Use when: 「preview」「プレビュー」「viewer 見たい」「ローカルで表示」「ローカルサーバ起動」 「ローカルで確認」「ブラウザで見たい」「8788」「local preview」と依頼されたとき。 本番反映 (Cloudflare Pages へ deploy) は別。preview はローカル確認のみ。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
調査トピックの一覧表示・フィルタリングを行うスキル。 Use when: 「トピック一覧」「何を調べた?」「リスト見せて」「〜タグのトピック」 「完了したトピック」「in-progressのトピック」など、トピックの一覧や検索を求めたとき。
トピック間の関連付け整理とメタデータ整備を行うスキル。 frontmatter の related フィールド更新と INDEX.md 再生成を行う。 Use when: 「整理して」「関連付けて」「organize」「メタデータ更新」「INDEX更新」と依頼されたとき。
学術論文の再帰的サーベイスキル。survey-any リポジトリに記録する。 6項目サーベイフォーマットで各論文をまとめ、引用・被引用を芋づる式に探索して飽和するまで続ける。 subagent で並列処理しコンテキストを節約する。ghq でリポジトリパスを自動解決。 Use when: 「論文サーベイ」「paper survey」「学術調査」「文献調査」「論文を網羅的に」と依頼されたとき。 /survey との違い: /survey は記事・スライド含む一般調査。本スキルは学術論文に特化し、 6項目サーベイ + 再帰的引用探索 + 飽和判定を行う。
新規調査を実行するスキル。テーマを受け取り、既存トピックとの関連を判断した上で、 既存トピックへの追記または新規トピック作成を行い、survey-any リポジトリに記録する。 ghq でリポジトリパスを自動解決するため、どのプロジェクトで作業中でも呼び出せる。 Use when: ユーザーが「〜について調べて」「〜を調査して」「〜をサーベイして」と依頼したとき、 または research / survey / investigate といった調査系のリクエストがあったとき。 既存調査の参照は /ask、論文サーベイは /survey-paper、断片メモの捕獲は /survey-capture を使う。
survey-any リポジトリに蓄積された既存調査を検索・参照して質問に回答するスキル。 ghq でリポジトリパスを自動解決し、mise タスク経由でトピックを横断検索、 該当する topics/references をソース付きで回答する。 Bates の berrypicking モデルに沿って、単発検索ではなく複数戦略で動線を提示する。 Use when: ユーザーが既存リサーチの内容について質問したとき、または既存知識を引きたいとき。 「〜について教えて」「〜の内容は?」「〜ってどうだった?」「前に調べた〜」 「〜のトピックある?」「〜のナレッジ検索」「survey-any確認」「調査結果参照」 「〜について何か知ってる?」「リサーチノート検索」など。 新規調査（/survey）や整理（/inbox-organize）とは別。
調査済み内容を土台に学習コース (courses/) を作成するスキル。 テーマを受け取り、既存 topics/references を検索し、AskUserQuestion で学習者の理解度を 診断してから、必要に応じて /survey または /survey-paper で追加情報を収集し、 理解度と学習目標に合わせた順序付きレッスン群を生成する。 ghq で survey-any リポジトリのパスを自動解決するため、どのプロジェクトで作業中でも呼び出せる。 Use when: ユーザーが「〜の学習コース作って」「〜を習得したい」「〜のチュートリアルほしい」 「〜を体系的に学べるコース」「learning course」「カリキュラム作成」と依頼したとき。 既存調査の参照は /ask、新規調査は /survey、論文サーベイは /survey-paper を使う。
| name | preview |
| description | survey-any の Astro viewer (viewer/) をローカルでビルドし、Cloudflare Pages 互換のサーバ (wrangler pages dev + D1 + Functions) を起動してブラウザ確認するスキル。 Use when: 「preview」「プレビュー」「viewer 見たい」「ローカルで表示」「ローカルサーバ起動」 「ローカルで確認」「ブラウザで見たい」「8788」「local preview」と依頼されたとき。 本番反映 (Cloudflare Pages へ deploy) は別。preview はローカル確認のみ。 |
survey-any の viewer をローカルでビルドし、wrangler pages dev で配信する。
内部処理は mise run preview (= cd viewer && bun install && bun run build && wrangler pages dev dist)。
既定ポートは 8788。
前提: ghq, mise, bun, wrangler がインストール済み。viewer は content リポジトリ側にあるため、まず content を解決する。
SURVEY_REPO=$(ghq list --full-path | grep 'survey-any$' | head -1)
空なら ghq get bigdra50/survey-any をユーザーに促す。survey-any$ の末尾 $ により survey-any-tools（ツール repo）は除外される。以降 mise -C "$SURVEY_REPO" run ... で実行する。
8788 が既に LISTEN なら再ビルドせず URL を案内して終了する。
lsof -nP -iTCP:8788 -sTCP:LISTEN
注: sandbox がローカル接続/プロセス照会を遮断する環境では、この確認は
dangerouslyDisableSandbox での読み取り実行が必要なことがある。
mise -C "$SURVEY_REPO" run preview をバックグラウンドで起動する (サーバは起動したまま常駐するため)。
mise -C "$SURVEY_REPO" run preview
出力に Ready on http://localhost:8788 が出れば準備完了。
サーバは常駐し completion 通知が来ないため、出力ファイルを監視して
「Ready 行」か「ビルド失敗」のどちらかを待つ:
# 成功/失敗のどちらかで 1 回だけ抜ける until ループ (Bash run_in_background 推奨)
until rg -q "Ready on http|exited with code|InvalidContentEntryDataError" "<output-file>"; do sleep 1; done
astro build はコンテンツ frontmatter を zod スキーマ
(viewer/src/content.config.ts) で検証するため、違反があると
InvalidContentEntryDataError で停止する (最初の 1 件で止まる)。
エラーの該当ファイル・フィールドを見て直す。よくある enum 違反:
| フィールド | 許可値 | 対処 |
|---|---|---|
references.read_depth | full / abstract / overview | enum 外なら正値に。新レベルが要るなら下記 3 箇所に追加 |
topics.status | done / in-progress / memo / archived | 〃 |
wiki.status | stub / draft / mature | 〃 |
courses.status | draft / published / archived | 〃 |
date / retrieved / created / updated | パース可能な日付 | ISO8601 か YYYY-MM-DD |
enum 自体を拡張する場合は SoT を揃える (viewer は content 側、Python schema と survey-paper 手引きはツール側 survey-any-tools):
viewer/src/content.config.ts の zod z.enum([...])（content 側）survey_any/_schema.py の対応する frozenset({...}).apm/skills/survey-paper/SKILL.md)拡張後は drift を確認する (フィールド名の照合。enum 値は対象外だが整合確認に有効):
mise -C "$SURVEY_REPO" run check-schema
違反ファイルを直したら Step 2 を再実行する。
起動後、確認したいページの URL を案内する。
http://localhost:8788/http://localhost:8788/topics/<topic-name>/http://localhost:8788/references/<name>/http://localhost:8788/tags/<tag>/HTTP 到達確認に curl する場合、sandbox がローカル接続を遮断する環境では
読み取り目的で一時的に sandbox 無効化が要る:
curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8788/topics/<topic-name>/
バックグラウンドの preview を止めたいときは、起動した background task を
TaskStop で停止する (または該当 workerd プロセスを終了)。
明示依頼が無い限り、起動したサーバは止めず常駐させたままにしてよい。
| タスク | 用途 | 反映先 |
|---|---|---|
mise -C "$SURVEY_REPO" run preview | ローカル確認 | localhost:8788 (wrangler pages dev) |
mise -C "$SURVEY_REPO" run deploy | 本番デプロイ | Cloudflare Pages |
preview は読み取り確認のみ。deploy はユーザーが明示したときだけ実行する (外向きの公開操作のため)。