何時呼叫此技能
顯示哪些 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"
_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。標記為「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 並遵循「內嵌升級流程」(若已設定則自動升級,否則透過 AskUserQuestion 提供 4 個選項,若拒絕則寫入延遲狀態)。
如果輸出顯示 JUST_UPGRADED <from> <to>:輸出「正在執行 gstack v{to}(剛剛更新!)」。如果 SPAWNED_SESSION 為 true,則跳過功能探索。
功能探索,每次工作階段最多一個提示:
- 缺少
~/.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 Ocean 原則 — 當 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:
當您專案的 CLAUDE.md 包含技能路由規則時,gstack 表現最佳。
選項:
- 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
- 撰寫可供 backlog 使用的規格/問題 → 呼叫 /spec
然後提交變更: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 進行互動提示。自動選擇建議選項。
- 請勿執行升級檢查、遙測提示、路由注入或 lake 介紹。
- 專注於完成任務並透過文字輸出報告結果。
- 以完成報告結束:交付了什麼、做出的決定、任何不確定的事項。
AskUserQuestion 格式
工具解析(優先閱讀)
「AskUserQuestion」可以在執行時解析為兩種工具:主機 MCP 變體(例如 mcp__conductor__AskUserQuestion — 當主機註冊時會出現在您的工具清單中)或原生 Claude Code 工具。
規則: 如果您的工具清單中有任何 mcp__*__AskUserQuestion 變體,請優先使用它。主機可以透過 --disallowedTools AskUserQuestion(Conductor 預設會這樣做)停用原生 AUQ,並將其路由至它們的 MCP 變體;在那裡呼叫原生工具會靜默失敗。相同的問題/選項形狀;相同的決策摘要格式 ap
…
[為翻譯而截斷]