/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 は、プランモードのターン終了要件を満たします。STOP ポイントでは、すぐに停止してください。ワークフローを続行したり、そこで ExitPlanMode を呼び出したりしないでください。「プランモード例外 — 常に実行」とマークされたコマンドは実行されます。ExitPlanMode は、スキルワークフローが完了した後、またはユーザーがスキルのキャンセルやプランモードの終了を指示した場合にのみ呼び出してください。
PROACTIVE が "false" の場合、スキルを自動的に呼び出したり、積極的に提案したりしないでください。スキルが役立つと思われる場合は、「/スキル名が役立つかもしれません — 実行しますか?」と尋ねてください。
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が存在しない場合: 継続的チェックポイントの自動コミットについて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 を呼び出す
- コードレビュー/diff チェック → /review を呼び出す
- ビジュアルポリッシュ → /design-review を呼び出す
- 出荷/デプロイ/PR → /ship または /land-and-deploy を呼び出す
- 進捗の保存 → /context-save を呼び出す
- コンテキストの復元 → /context-restore を呼び出す
次に変更をコミットします: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
B の場合: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true を実行し、gstack-config set routing_declined false で再有効化できることを伝えます。
これはプロジェクトごとに一度だけ発生します。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: migrate gstack from vendored to team mode"を実行します。- ユーザーに伝えます: 「完了しました。各開発者は次を実行します:
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 は意思決定の要約であり、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 は常に存在し、平易な英語であり、関数名ではありません。推奨は常に存在します。(推奨) ラベルを保持します。AUTO_DECIDE はこれに依存します。
完全性: オプションがカバレッジで異なる場合のみ Completeness: N/10 を使用します。10 = 完全、7 = ハッピーパス、3 = ショートカット。オプションの種類が異なる場合は、次のように記述します: 注意: オプションは種類が異なり、カバレッジではありません — 完全性スコアはありません。
長所/短所: ✅ と ❌ を使用します。選択が実際に行われる場合、オプションごとに最低2つの長所と1つの短所、各箇条書きは最低40文字。一方通行/破壊的な確認のためのハードストップエスケープ: ✅ 短所なし — これは一方通行の選択です。
中立の姿勢: 推奨: <デフォルト> — これは好みの問題であり、どちらかに強い好みはありません; (推奨) は、AUTO_DECIDE のためにデフォルトオプションに残ります。
労力の両軸: オプションに労力が伴う場合、人間チームと CC+gstack の両方の時間をラベル付けします。例: (人間: 約2日 / CC: 約15分)。これにより、意思決定時に AI の圧縮が可視化されます。
ネット行はトレードオフを締めくくります。スキルごとの指示により、より厳しいルールが追加される場合があります。
出力前のセルフチェック
AskUserQuestion を呼び出す前に、以下を確認してください:
- D ヘッダーが存在する
- ELI10 段落が存在する (利害関係の行も)
- 推奨行が具体的な理由とともに存在する
- 完全性が採点されている (カバレッジ) または種類に関する注記が存在する (種類)
- すべてのオプションに ≥2 つの ✅ と ≥1 つの ❌ があり、それぞれ ≥40 文字 (またはハードストップエスケープ)