이 스킬을 호출하는 경우
현재 오픈 PR에 의해 클레임된 VERSION 슬롯, 곧 출시될 WIP 작업이 있는 형제 Conductor 워크스페이스, 그리고 /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 host: AskUserQuestion is unreliable here (native disabled, MCP
# variant flaky), so skills render decisions as prose instead of calling the
# tool. Gated on !headless so an eval/CI run INSIDE Conductor (GSTACK_HEADLESS)
# still BLOCKs rather than rendering prose to nobody.
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"
# First-run project detection: run the detector ONLY on the first-ever skill run
# (ACTIVATED=no, interactive) so it stays off the hot path for every run after.
_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"
_UPDATE_CHECK=$(~/.claude/skills/gstack/bin/gstack-config get update_check 2>/dev/null || echo "true")
echo "UPDATE_CHECK: $_UPDATE_CHECK"
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 "$HOME/.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"
for _RF in CLAUDE.md AGENTS.md; do
if [ -f "$_RF" ] && grep -q "## Skill routing" "$_RF" 2>/dev/null; then
_HAS_ROUTING="yes"
fi
done
_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"
# Plan-mode hint for skills like /spec that branch behavior on plan-mode state.
# Claude Code exposes plan mode via system reminders; we detect best-effort
# from CLAUDE_PLAN_FILE (set by the harness when plan mode is active) and
# fall back to "inactive". Codex hosts and Claude execution mode both end up
# inactive, which is the safe default (defaults to file+execute pipeline).
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 형식 실패 대체(fallback)를 따릅니다: headless → BLOCKED; interactive → 산문 대체 (종료 요구 사항도 충족). STOP 지점에서 즉시 중지하십시오. 거기서 워크플로우를 계속하거나 ExitPlanMode를 호출하지 마십시오. "PLAN MODE EXCEPTION — ALWAYS RUN"으로 표시된 명령은 실행됩니다. 스킬 워크플로우가 완료된 후에만 ExitPlanMode를 호출하거나, 사용자가 스킬을 취소하거나 계획 모드를 종료하라고 지시한 경우에만 호출하십시오.
PROACTIVE가 "false"인 경우 스킬을 자동 호출하거나 사전에 제안하지 마십시오. 스킬이 유용해 보이면 "해당 스킬이 여기에 도움이 될 수 있습니다. 실행하시겠습니까?"라고 물어보십시오.
SKILL_PREFIX가 "true"인 경우 /gstack-* 이름을 제안/호출하십시오. 디스크 경로는 ~/.claude/skills/gstack/[skill-name]/SKILL.md를 유지하십시오.
UPDATE_CHECK가 "false"인 경우, 다음 두 줄을 건너뛰십시오 — 업데이트 확인 바이너리는 해당 모드에서 아무것도 출력하지 않으므로 UPGRADE_AVAILABLE / JUST_UPGRADED 출력이 없습니다.
출력에 UPGRADE_AVAILABLE <old> <new>가 표시되면: ~/.claude/skills/gstack/gstack-upgrade/SKILL.md를 읽고 "인라인 업그레이드 흐름"을 따르십시오 (구성된 경우 자동 업그레이드, 그렇지 않으면 4가지 옵션이 있는 AskUserQuestion, 거부 시 snooze 상태 쓰기).
출력에 JUST_UPGRADED <from> <to>가 표시되면: "Running gstack v{to} (just updated!)"를 출력하십시오. 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 프롬프트가 더 간단합니다: 처음 사용자를 위한 전문 용어 설명, 결과 중심 질문, 더 짧은 문장. 기본값을 유지하거나 terse 스타일로 되돌리시겠습니까?
옵션:
- 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의 한계 비용이 거의 0에 가까울 때 완전한 작업을 수행하십시오. 자세히 보기: 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이면 건너뜁니다.
첫 실행 안내 (일회성)
ACTIVATED가 no(이 머신에서 첫 스킬 실행)이고 준비 작업에서 비어 있지 않은 FIRST_TASK: 값을 출력했으며 nongit가 아닌 경우: 토큰에서 매핑된 간단한 프로젝트별 한 줄을 미리 알림으로 표시한 다음 사용자가 실제로 요청한 모든 작업을 계속 진행하십시오 — 작업을 중단하지 마십시오. 토큰 매핑: 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은 한 번의 루프를 완료할 때 효과를 발휘합니다 — 계획 → 검토 → 출시. 일반적인 첫 루프: 형태를 만들려면
/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) 아니요, 수동으로 스킬을 호출하겠
…
[번역을 위해 잘림]