プリアンブル(最初に実行)
_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":"gstack","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":"gstack","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が利用できません」とAskUserQuestionの形式ルールに従って報告してください。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がない場合: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) オフにする。自分で/commandsを入力します
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ツールを介して呼び出します。迷った場合はスキルを呼び出します。
主要なルーティングルール:
- 製品アイデア/ブレインストーミング → /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で一度警告します:
このプロジェクトではgstackが
.claude/skills/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を使用しないでください。推奨オプションを自動選択します。
- アップグレードチェック、テレメトリプロンプト、ルーティング注入、レイクイントロを実行しないでください。
- タスクの完了に集中し、散文出力で結果を報告します。
- 完了レポートで終了:何が出荷されたか、決定事項、不確かな点。
アーティファクト同期(スキル開始時)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# v1.27.0.0のアーティファクトファイルを優先し、移行スクリプトが実行される前に
# 移行中のユーザー向けにブレインファイルにフォールバックします。
if [ -f "$HOME/.gstack-artifacts-remote.txt" ]; then
_BRAIN_REMOTE_FILE="$HOME/.gstack-artifacts-remote.txt"
else
_BRAIN_REMOTE_FILE="$HOME/.gstack-brain-remote.txt"
fi
_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
# /sync-gbrain context-load: gbrainが利用可能な場合にエージェントに使用を指示します。
# ワークツリーごとのピン:ポストスパイク再設計では、gitのトップレベルにあるkubectlスタイルの`.gbrain-source`を使用して
# クエリのスコープを設定します。グローバルな状態ファイルではなく、ワークツリー内のピンを探すため、
# ワークツリーAが同期されたからといって、ピンのないワークツリーBが「インデックス済み」と
# 主張することはありません。gbrainが設定されていない場合は空文字列(非gbrainユーザーには
# ゼロコンテキストコスト)。
_GBRAIN_CONFIG="$HOME/.gbrain/config.json"
if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_VERSION_OK=$(gbrain --version 2>/dev/null | grep -c '^gbrain ' || echo 0)
if [ "$_GBRAIN_VERSION_OK" -gt 0 ] 2>/dev/null; then
_GBRAIN_PIN_PATH=""
_REPO_TOP=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
if [ -n "$_REPO_TOP" ] && [ -f "$_REPO_TOP/.gbrain-source" ]; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
echo "GBrain設定済み。意味的な質問にはGrepよりも`gbrain search`/`gbrain query`を優先。"
echo "シンボル対応のコード検索には`gbrain code-def`/`code-refs`/`code-callers`を使用。"
echo "「## CLAUDE.mdのGBrain検索ガイダンス」を参照。"
echo "更新するには/sync-gbrainを実行。"
else
echo "GBrainは設定されていますが、このワークツリーはまだピンされていません。`/sync-gbrain --full`を実行してから、"
echo "このワークツリーのコード質問に`gbrain search`を使用してください。"
echo "ピンされるまではGrepにフォールバックします。"
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_sync)
…
[翻訳のため切り詰め]