/landing-report — 版本队列仪表盘
序言(首先运行)
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
GSTACK_ROOT="$HOME/.cursor/skills/gstack"
[ -n "$_ROOT" ] && [ -d "$_ROOT/.cursor/skills/gstack" ] && GSTACK_ROOT="$_ROOT/.cursor/skills/gstack"
GSTACK_BIN="$GSTACK_ROOT/bin"
GSTACK_BROWSE="$GSTACK_ROOT/browse/dist"
GSTACK_DESIGN="$GSTACK_ROOT/design/dist"
_UPD=$($GSTACK_BIN/gstack-update-check 2>/dev/null || .cursor/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=$($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=$($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 <($GSTACK_BIN/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$($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 内的评估/CI 运行(GSTACK_HEADLESS)
# 仍然会 BLOCK,而不是向虚无呈现散文。
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=$($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=$($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=$($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=$($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 "$GSTACK_BIN/gstack-telemetry-log" ]; then
$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 "$($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
$GSTACK_BIN/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
$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=$($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 ".cursor/skills/gstack" ] && [ ! -L ".cursor/skills/gstack" ]; then
if [ -f ".cursor/skills/gstack/VERSION" ] || [ -d ".cursor/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$($GSTACK_BIN/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$($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(当计划模式激活时由 harness 设置)检测,
# 后备为 "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-* 名称。磁盘路径保持为 $GSTACK_ROOT/[skill-name]/SKILL.md。
如果输出显示 UPGRADE_AVAILABLE <old> <new>:读取 $GSTACK_ROOT/gstack-upgrade/SKILL.md 并遵循 "内联升级流程"(如果配置了则自动升级,否则使用 4 个选项的 AskUserQuestion,如果拒绝则写入休眠状态)。
如果输出显示 JUST_UPGRADED <from> <to>:打印 "正在运行 gstack v{to}(刚刚更新!)"。如果 SPAWNED_SESSION 为 true,则跳过功能发现。
功能发现,每个会话最多一次提示:
- 缺少
$GSTACK_ROOT/.feature-prompted-continuous-checkpoint:使用 AskUserQuestion 询问 Continuous checkpoint 自动提交。如果接受,运行$GSTACK_BIN/gstack-config set checkpoint_mode continuous。始终触摸标记。 - 缺少
$GSTACK_ROOT/.feature-prompted-model-overlay:通知 "模型覆盖层已激活。MODEL_OVERLAY 显示补丁。" 始终触摸标记。
升级提示后,继续工作流。
如果 WRITING_STYLE_PENDING 为 yes:询问一次关于写作风格的问题:
v1 提示更简洁:首次使用的行话解释、以结果为导向的问题、更短的散文。保留默认值还是恢复简洁?
选项:
- A) 保留新的默认值(推荐 — 好的写作对每个人都有帮助)
- B) 恢复 V0 散文 — 设置
explain_level: terse
如果选择 A:保持 explain_level 未设置(默认为 default)。
如果选择 B:运行 $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:运行 $GSTACK_BIN/gstack-config set telemetry community
如果选择 B:询问后续问题:
匿名模式仅发送聚合使用数据,不包含唯一 ID。
选项:
- A) 当然,匿名就可以
- B) 不了,谢谢,完全关闭
如果选择 B→A:运行 $GSTACK_BIN/gstack-config set telemetry anonymous
如果选择 B→B:运行 $GSTACK_BIN/gstack-config set telemetry off
始终运行:
touch ~/.gstack/.telemetry-prompted
如果 TEL_PROMPTED 为 yes,则跳过。
如果 PROACTIVE_PROMPTED 为 no 且 TEL_PROMPTED 为 yes:询问一次:
允许 gstack 主动建议技能,例如针对 "这个能用吗?" 的 /qa 或针对 bug 的 /investigate?
选项:
- A) 保持开启(推荐)
- B) 关闭 — 我自己输入 /commands
如果选择 A:运行 $GSTACK_BIN/gstack-config set proactive true
如果选择 B:运行 $GSTACK_BIN/gstack-config set proactive false
始终运行:
touch ~/.gstack/.proactive-prompted
如果 PROACTIVE_PROMPTED 为 yes,则跳过。
首次运行引导(一次性)
如果 ACTIVATED 为 no(此机器上首次运行技能)且 preamble 打印了非空的 FIRST_TASK: 值且该值不是 nongit:根据 token 显示一条简短的、特定于项目的行作为提醒,然后继续处理用户实际请求的内容 — 不要中断他们的任务。映射 token: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。" 然后用您看到的 token 替换 TASK_TOKEN 并运行(尽力而为),并标记为已激活:
$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:
当您项目的 CLAUDE.md 包含技能路由规则时,gstack 效果最佳。
选项:
- A) 将路由规则添加到 CLAUDE.md(推荐)
- B) 不了,谢谢,我会手动调用技能
如果选择 A:将此部分追加到 CLAUDE.md 的末尾:
## 技能路由
当用户的请求与可用技能匹配时,通过技能工具调用它。如有疑问,请调用该技能。
关键路由规则:
- 产品创意/头脑风暴 → 调用 /office-hours
- 策略/范围 → 调用 /plan-ceo-review
- 架构 → 调用 /plan-eng-review
- 设计系统/计划审查 → 调用 /design-consultation 或 /plan-design-review
- 完整审查管道 → 调用 /autoplan
- Bug/错误 → 调用 /investigate
- QA/测试站点行为 → 调用 /qa 或 /qa-only
- 代码审查/差异检查 → 调用 /review
- 视觉打磨 → 调用 /design-review
- 发版/部署/PR → 调用 /ship 或 /land-and-deploy
- 保存进度 → 调用 /context-save
- 恢复上下文 → 调用 /context-restore
- 编写可入积压的规格/问题 → 调用 /spec
然后提交更改:git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
如果选择 B:运行 `$GSTACK_BIN/gstack-
…
[为翻译截断]