このスキルを呼び出すタイミング
どのVERSIONスロットが現在オープン中のPRによって占有されているか、どの兄弟Conductorワークスペースに間もなく出荷されるWIP作業があるか、そして次に /ship がどのスロットを選択するかを表示します。変更は一切行わず、スナップショットのみを提供します。「着陸レポートを見せて」「キューの中身は?」「オープン中のPRを見せて」「次にどのバージョンを取得すればいい?」と聞かれたときに使用します。
/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"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Conductorホスト: AskUserQuestionはここでは信頼性が低い(ネイティブ無効、MCP
# バリアントが不安定)ため、スキルはツールを呼び出す代わりに判断を散文としてレンダリングします。
# headlessでない場合にゲートされ、Conductor内のeval/CI実行(GSTACK_HEADLESS)が
# 誰にも散文をレンダリングせずにブロックするようにします。
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# 初回実行時プロジェクト検出: 初回スキル実行時のみ検出器を実行
# (ACTIVATED=no、インタラクティブ)し、以降の実行ではホットパスから外します。
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_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":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-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"
# プランモードのヒント: /spec のようにプランモード状態に応じて動作を分岐するスキル向け。
# Claude Codeはシステムリマインダーを通じてプランモードを公開します。
# CLAUDE_PLAN_FILE(プランモードがアクティブなときにハーネスによって設定される)から
# ベストエフォートで検出し、"inactive"にフォールバックします。
# CodexホストとClaude実行モードはどちらもinactiveになり、これは安全なデフォルトです
# (デフォルトでファイル+実行パイプラインに)。
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
export GSTACK_PLAN_MODE="active"
else
export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
プランモードでの安全な操作
プランモードでは、計画に情報を提供するため、以下が許可されます: $B、$D、codex exec/codex review、~/.gstack/への書き込み、計画ファイルへの書き込み、および生成されたアーティファクトのためのopen。
プランモード中のスキル呼び出し
ユーザーがプランモードでスキルを呼び出した場合、スキルが一般的なプランモードの動作よりも優先されます。スキルファイルを実行可能な指示として扱い、参照として扱わないでください。 ステップ0から順に従ってください。最初のAskUserQuestionはワークフローがプランモードに入ることであり、違反ではありません。AskUserQuestion(任意のバリアント — mcp__*__AskUserQuestion またはネイティブ; 「AskUserQuestionの形式 → ツール解決」を参照)は、プランモードのターン終了要件を満たします。AskUserQuestionが利用できない場合や呼び出しが失敗した場合、AskUserQuestion形式の失敗フォールバックに従ってください: headless → BLOCKED; interactive → 散文フォールバック(こちらもターン終了要件を満たします)。STOPポイントで、すぐに停止してください。そこでワークフローを続行したり、ExitPlanModeを呼び出したりしないでください。「プランモード例外 — 常に実行」とマークされたコマンドは実行されます。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がない: 継続的チェックポイントの自動コミットについて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は海を沸騰させる原則に従っています — 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の場合はスキップ。
初回実行ガイダンス(1回のみ)
ACTIVATEDがno(このマシンでの初回スキル実行)で、かつプレアンブルが空でないFIRST_TASK:値(nongit以外)を出力した場合: トークンからマッピングされた、プロジェクト固有の短い行を1つだけヒントとして表示し、その後ユーザーが実際に尋ねたことを続行 — タスクを停止しないでください。トークンをマッピング: greenfield → 「新しいリポジトリです — 最初に /spec または /office-hours で形を整えてください。」 code_node/code_python/code_rust/code_go/code_ruby/code_ios → 「ここにはコードがあります — /qa で動作を確認するか、何か問題があれば /investigate を使用してください。」 branch_ahead → 「このブランチには未出荷の作業があります — /review の後に /ship を使用してください。」 dirty_default → 「コミットされていない変更があります — コミット前に /review を使用してください。」 clean_default → 「いずれかを選択: /spec、/investigate、または /qa。」 次に、表示されたトークンをTASK_TOKENに置き換えて実行(ベストエフォート)し、アクティブ化をマーク:
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true
ACTIVATEDがnoで、かつFIRST_TASK:が空またはnongit(ヘッドレス、非git、またはアクション可能なものがない)の場合: 何も表示せず、touch ~/.gstack/.activated 2>/dev/null || trueだけ実行。
それ以外の場合で、ACTIVATEDがyesで、かつFIRST_LOOP_SHOWNがnoの場合: ヒントとして一度だけ表示(その後続行):
ヒント: gstackは計画 → レビュー → 出荷の1ループを完了すると価値が発揮されます。一般的な最初のループ:
/office-hoursまたは/specで形を整え、/plan-eng-reviewで確定し、その後/shipを実行します。
その後、touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || trueを実行。
ACTIVATEDとFIRST_LOOP_SHOWNが両方とも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 を呼び出し
- 変更のレビュー → /review を呼び出し
- 変更の出荷 → /ship を呼び出し
- 出荷キューの表示 → /landing-report を呼び出し
これらが設定された後、スキップするには touch ~/.gstack/.routing-declined を実行。
Bの場合: touch ~/.gstack/.routing-declined 2>/dev/null || trueを実行。
ルーティングが設定され、VENDORED_GSTACKがnoの場合: ベンダリングについて一度提案:
gstackをこのリポジトリにベンダリング(.claude/skills/gstack にコピー)すると、チーム全員が同じバージョンを使用できます。ベンダリングしますか?
オプション:
- A) はい、ベンダリングする(推奨)
- B) 結構です
Aの場合: ~/.claude/skills/gstack/bin/gstack-vendorを実行(これにより、必要に応じてフックも設定される可能性があります)。
Bの場合: 何もしない。
このプロンプトをセッションごとに最大1回表示。