序言(先运行)
_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 unavailable 并遵循 AskUserQuestion 格式规则。在 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 个选项,如果拒绝则写入 snooze 状态)。
如果输出显示 JUST_UPGRADED <from> <to>:打印“Running gstack v{to} (just updated!)”。如果 SPAWNED_SESSION 为 true,则跳过功能发现。
功能发现,每个会话最多一次提示:
- 缺少
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint:AskUserQuestion 关于 Continuous checkpoint 自动提交。如果接受,运行~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous。始终触摸标记文件。 - 缺少
~/.claude/skills/gstack/.feature-prompted-model-overlay:告知“Model overlays are active. MODEL_OVERLAY shows the patch.”始终触摸标记文件。
升级提示后,继续工作流。
如果 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 follows the Boil the Lake principle, do the complete thing when AI makes marginal cost near-zero. Read more: 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 询问一次遥测:
Help gstack get better. Share usage data only: skill, duration, crashes, stable device ID. No code, file paths, or repo names.
选项:
- A) 帮助 gstack 变得更好!(推荐)
- B) 不了,谢谢
如果选择 A:运行 ~/.claude/skills/gstack/bin/gstack-config set telemetry community
如果选择 B:询问后续问题:
Anonymous mode sends only aggregate usage, no unique 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:询问一次:
Let gstack proactively suggest skills, like /qa for "does this work?" or /investigate for bugs?
选项:
- 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 works best when your project's CLAUDE.md includes skill routing rules.
选项:
- A) 向 CLAUDE.md 添加路由规则(推荐)
- B) 不了,我会手动调用技能
如果选择 A:将此部分附加到 CLAUDE.md 末尾:
## Skill routing
When the user's request matches an available skill, invoke it via the Skill tool. When in doubt, invoke the skill.
Key routing rules:
- Product ideas/brainstorming → invoke /office-hours
- Strategy/scope → invoke /plan-ceo-review
- Architecture → invoke /plan-eng-review
- Design system/plan review → invoke /design-consultation or /plan-design-review
- Full review pipeline → invoke /autoplan
- Bugs/errors → invoke /investigate
- QA/testing site behavior → invoke /qa or /qa-only
- Code review/diff check → invoke /review
- Visual polish → invoke /design-review
- Ship/deploy/PR → invoke /ship or /land-and-deploy
- Save progress → invoke /context-save
- Resume context → invoke /context-restore
然后提交更改: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 警告一次:
This project has gstack vendored in
.claude/skills/gstack/. Vendoring is deprecated. Migrate to team mode?
选项:
- 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" - 告知用户:“Done. Each developer now runs:
cd ~/.claude/skills/gstack && ./setup --team”
如果选择 B:说“OK, you're on your own to keep the vendored copy up to date.”
始终运行(无论选择哪个):
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 介绍。
- 专注于完成任务并通过文本输出报告结果。
- 以完成报告结尾:记录了哪些内容、做出的决策、任何不确定之处。
Artifacts 同步(技能启动时)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# 优先使用 v1.27.0.0 的 artifacts 文件;对于在迁移脚本运行前升级中途的用户,回退到 brain 文件。
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。
# 每个工作树固定:重新设计后使用 kubectl 风格的 `.gbrain-source` 位于
# git 顶层以限定查询范围。在工作树中(而非全局状态文件)查找固定点,
# 以便打开没有固定点的工作树 B 不会仅仅因为工作树 A 已同步而声称“已索引”。
# 当 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 configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
echo "Falls back to Grep until pinned."
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_sy