/landing-report — バージョンキューダッシュボード
プリアンブル(最初に実行)
_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
if [ -f "$_PF" ]; then
if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
fi
rm -f "$_PF" 2>/dev/null || true
fi
break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
_LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
echo "LEARNINGS: $_LEARN_COUNT entries loaded"
if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
_HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
プランモードでの安全な操作
プランモードでは、これらは計画に情報を提供するため許可されています:$B、$D、codex exec/codex review、~/.gstack/ への書き込み、計画ファイルへの書き込み、生成されたアーティファクトのための open。
プランモード中のスキル呼び出し
ユーザーがプランモードでスキルを呼び出した場合、スキルは一般的なプランモードの動作よりも優先されます。スキルファイルを実行可能な指示として扱い、参照としては扱わないでください。 ステップ 0 から順に従ってください。最初の AskUserQuestion はワークフローがプランモードに入ることであり、プランモードの違反ではありません。AskUserQuestion(任意のバリアント — mcp__*__AskUserQuestion またはネイティブ;「AskUserQuestion 形式 → ツール解決」を参照)はプランモードのターン終了要件を満たします。呼び出し可能なバリアントがない場合、スキルは BLOCKED です — 停止して BLOCKED — AskUserQuestion unavailable を報告し、AskUserQuestion 形式ルールに従ってください。STOP ポイントでは、すぐに停止してください。ワークフローを続行したり、そこで ExitPlanMode を呼び出したりしないでください。「PLAN MODE EXCEPTION — ALWAYS RUN」とマークされたコマンドは実行されます。ExitPlanMode はスキルワークフローが完了した後、またはユーザーがスキルをキャンセルするかプランモードを終了するように指示した場合にのみ呼び出してください。
PROACTIVE が "false" の場合、スキルを自動的に呼び出したり、積極的に提案したりしないでください。スキルが役立つと思われる場合は、次のように尋ねてください。「/skillname が役立つかもしれませんが、実行しますか?」
SKILL_PREFIX が "true" の場合、/gstack-* 名を提案/呼び出してください。ディスクパスは ~/.claude/skills/gstack/[skill-name]/SKILL.md のままです。
出力に UPGRADE_AVAILABLE <old> <new> が表示された場合:~/.claude/skills/gstack/gstack-upgrade/SKILL.md を読み、「インラインアップグレードフロー」に従ってください(設定されていれば自動アップグレード、そうでなければ4つのオプションで AskUserQuestion、辞退した場合はスヌーズ状態を書き込み)。
出力に JUST_UPGRADED <from> <to> が表示された場合:「gstack v{to} を実行中(更新されました!)」と出力します。SPAWNED_SESSION が true の場合、機能発見をスキップします。
機能発見、セッションごとに最大1回のプロンプト:
~/.claude/skills/gstack/.feature-prompted-continuous-checkpointがない場合:Continuous チェックポイント自動コミットについて AskUserQuestion。承諾された場合、~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuousを実行。常にマーカーを作成。~/.claude/skills/gstack/.feature-prompted-model-overlayがない場合:「モデルオーバーレイがアクティブです。MODEL_OVERLAY がパッチを示しています。」と通知。常にマーカーを作成。
アップグレードプロンプトの後、ワークフローを続行します。
WRITING_STYLE_PENDING が yes の場合:一度だけ執筆スタイルについて尋ねます:
v1 プロンプトはよりシンプルです:初回使用時の専門用語の説明、結果重視の質問、短い散文。デフォルトを維持するか、簡潔に戻しますか?
オプション:
- A) 新しいデフォルトを維持する(推奨 — 良い文章は全員を助ける)
- B) V0 の散文に戻す —
explain_level: terseを設定
A の場合:explain_level を設定しないままにします(デフォルトは default)。
B の場合:~/.claude/skills/gstack/bin/gstack-config set explain_level terse を実行。
常に実行(選択に関わらず):
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
WRITING_STYLE_PENDING が no の場合はスキップします。
LAKE_INTRO が no の場合:「gstack は Boil the Lake の原則に従います — AI が限界費用をほぼゼロにするとき、完全なことを行います。詳細:https://garryslist.org/posts/boil-the-ocean」と言います。開くことを提案します:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
open は「はい」の場合のみ実行します。touch は常に実行します。
TEL_PROMPTED が no かつ LAKE_INTRO が yes の場合:一度だけ AskUserQuestion でテレメトリについて尋ねます:
gstack の改善にご協力ください。使用状況データのみを共有:スキル、期間、クラッシュ、安定したデバイス ID。コード、ファイルパス、リポジトリ名は含まれません。
オプション:
- A) gstack の改善にご協力ください!(推奨)
- B) いいえ、結構です
A の場合:~/.claude/skills/gstack/bin/gstack-config set telemetry community を実行
B の場合:フォローアップを尋ねます:
匿名モードでは、一意の ID なしで集計使用状況のみを送信します。
オプション:
- A) はい、匿名で問題ありません
- B) いいえ、完全にオフにします
B→A の場合:~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous を実行
B→B の場合:~/.claude/skills/gstack/bin/gstack-config set telemetry off を実行
常に実行:
touch ~/.gstack/.telemetry-prompted
TEL_PROMPTED が yes の場合はスキップします。
PROACTIVE_PROMPTED が no かつ TEL_PROMPTED が yes の場合:一度だけ尋ねます:
gstack が積極的にスキルを提案するようにしますか?例:/qa(「これは動作しますか?」)や /investigate(バグ用)など。
オプション:
- A) オンにする(推奨)
- B) オフにする — 自分で /コマンドを入力します
A の場合:~/.claude/skills/gstack/bin/gstack-config set proactive true を実行
B の場合:~/.claude/skills/gstack/bin/gstack-config set proactive false を実行
常に実行:
touch ~/.gstack/.proactive-prompted
PROACTIVE_PROMPTED が yes の場合はスキップします。
HAS_ROUTING が no かつ ROUTING_DECLINED が false かつ PROACTIVE_PROMPTED が yes の場合:
プロジェクトルートに CLAUDE.md ファイルが存在するか確認します。存在しない場合は作成します。
AskUserQuestion を使用:
gstack は、プロジェクトの CLAUDE.md にスキルルーティングルールが含まれているときに最も効果的に動作します。
オプション:
- A) CLAUDE.md にルーティングルールを追加する(推奨)
- B) いいえ、手動でスキルを呼び出します
A の場合:このセクションを CLAUDE.md の最後に追加します:
## Skill routing
ユーザーのリクエストが利用可能なスキルに一致する場合、Skill ツールを介してそれを呼び出します。 疑わしい場合は、スキルを呼び出します。
主要なルーティングルール:
- 製品アイデア/ブレインストーミング → /office-hours を呼び出す
- 戦略/スコープ → /plan-ceo-review を呼び出す
- アーキテクチャ → /plan-eng-review を呼び出す
- デザインシステム/計画レビュー → /design-consultation または /plan-design-review を呼び出す
- 完全なレビューパイプライン → /autoplan を呼び出す
- バグ/エラー → /investigate を呼び出す
- QA/テストサイトの動作 → /qa または /qa-only を呼び出す
- コードレビュー/差分チェック → /review を呼び出す
- 視覚的な仕上げ → /design-review を呼び出す
- 出荷/デプロイ/PR → /ship または /land-and-deploy を呼び出す
- 進行状況を保存 → /context-save を呼び出す
- コンテキストを復元 → /context-restore を呼び出す
次に、変更をコミットします:git add CLAUDE.md && git commit -m "chore: gstack スキルルーティングルールを CLAUDE.md に追加"
B の場合:~/.claude/skills/gstack/bin/gstack-config set routing_declined true を実行し、gstack-config set routing_declined false で再び有効にできることを伝えます。
これはプロジェクトごとに1回のみ発生します。HAS_ROUTING が yes または ROUTING_DECLINED が true の場合はスキップします。
VENDORED_GSTACK が yes の場合、~/.gstack/.vendoring-warned-$SLUG が存在しない限り、AskUserQuestion で一度警告します:
このプロジェクトは
.claude/skills/gstack/に gstack をベンダリングしています。ベンダリングは非推奨です。 チームモードに移行しますか?
オプション:
- A) はい、今すぐチームモードに移行する
- B) いいえ、自分で処理します
A の場合:
git rm -r .claude/skills/gstack/を実行echo '.claude/skills/gstack/' >> .gitignoreを実行~/.claude/skills/gstack/bin/gstack-team-init required(またはoptional)を実行git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: gstack をベンダリングからチームモードに移行"を実行- ユーザーに伝える:「完了しました。各開発者は以下を実行します:
cd ~/.claude/skills/gstack && ./setup --team」
B の場合:「了解です。ベンダリングされたコピーを最新の状態に保つのはご自身で行ってください。」と言います。
常に実行(選択に関わらず):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
マーカーが存在する場合はスキップします。
SPAWNED_SESSION が "true" の場合、AI オーケストレーター(例:OpenClaw)によって生成されたセッション内で実行されています。生成されたセッションでは:
- 対話型プロンプトに AskUserQuestion を使用しないでください。推奨オプションを自動選択します。
- アップグレードチェック、テレメトリプロンプト、ルーティング注入、またはレイクの紹介を実行しないでください。
- タスクの完了と散文出力による結果の報告に集中します。
- 完了レポートで終了します:何が出荷されたか、下された決定、不確かなこと。
AskUserQuestion 形式
ツール解決(最初にお読みください)
「AskUserQuestion」は実行時に2つのツールに解決できます:ホスト MCP バリアント(例:mcp__conductor__AskUserQuestion — ホストが登録するとツールリストに表示されます)またはネイティブ Claude Code ツール。
ルール: いずれかの mcp__*__AskUserQuestion バリアントがツールリストにある場合、そちらを優先します。ホストは --disallowedTools AskUserQuestion(Conductor はデフォルトでこれを行います)を介してネイティブ AUQ を無効にし、MCP バリアントを経由させることができます。ネイティブを呼び出すと、その場で失敗します。同じ質問/オプションの形式です。同じ決定ブリーフ形式が適用されます。
AskUserQuestion バリアントがツールリストにない場合、このスキルは BLOCKED です。 停止し、BLOCKED — AskUserQuestion unavailable を報告し、ユーザーを待ちます。計画ファイルに決定を代わりに書き込んだり、散文として出力して停止したり、静かに自動決定したりしないでください(/plan-tune AUTO_DECIDE オプトインのみが自動選択を許可します)。
形式
すべての AskUserQuestion は決定ブリーフであり、散文ではなく tool_use として送信する必要があります。
D<N> — <1行の質問タイトル>
プロジェクト/ブランチ/タスク:<_BRANCH を使用した1つの短い基本文>
ELI10:<16歳が理解できる平易な英語、2〜4文、利害関係を述べる>
間違った場合のリスク:<何が壊れるか、ユーザーは何を見るか、何が失われるかについての1文>
推奨:<選択肢> 理由:<1行の理由>
完全性:A=X/10、B=Y/10 (または注:オプションは種類が異なり、カバレッジではない — 完全性スコアなし)
長所/短所:
A) <オプションラベル>(推奨)
✅ <長所 — 具体的で観測可能、40文字以上>
❌ <短所 — 正直、40文字以上>
B) <オプションラベル>
✅ <長所>
❌ <短所>
ネット:<実際に何をトレードオフしているかの1行の統合>
D-番号付け:スキル呼び出しの最初の質問は D1 です。自分でインクリメントします。これはモデルレベルの指示であり、実行時カウンターではありません。
ELI10 は常に存在し、平易な英語で、関数名ではありません。推奨は常に存在します。(recommended) ラベルを維持します。AUTO_DECIDE はそれに依存します。
完全性:Completeness: N/10 を使用
…[翻訳のため省略]