Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

一個唯讀的版本佇列儀表板,用於知悉工作區感知的發布狀態(gstack)。

Tony-Claude-Code-Skills 是什麼?

此技能提供一個唯讀的「版本佇列儀表板」,讓開發者或 AI 代理能夠快速檢視目前有哪些版本(VERSION)插槽被開啟的拉取請求(PR)佔用、哪些共軛(Conductor)工作區有正在進行且可能即將發布的工作,以及下一次 `/ship` 命令會選取哪個插槽。它不會進行任何修改操作,僅是擷取當下快照。此技能支援 Claude Code、Cursor、Codex 等平台,透過執行一連串的 Bash 腳本(如 `gstack-update-check`、`gstack-config`、`gstack-repo-mode`)來收集環境資訊,包括分支名稱、工作階段類型、是否為 Conductor 工作區、以及各種設定值(如 `proactive`、`skill_prefix`、`telemetry`)。除了核心的佇列查詢功能外,它還包含一次性的使用者引導流程(如專案偵測、功能提示、寫作風格詢問),以及計畫模式(Plan Mode)下的安全操作與技能調用規則。如果 `PROACTIVE` 設定為 `false`,技能不會自動觸發或主動建議;若 `SKILL_PREFIX` 為 `true`,則建議使用 `/gstack-*` 格式的名稱。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/gstack/landing-report

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

何時叫用此技能

顯示哪些 VERSION 插槽 目前被開啟的 PR 佔用、哪些共軛(Conductor)工作區有正在進行且可能即將發布的工作,以及下次 /ship 會選取哪個插槽。唯讀操作 — 僅為目前狀態的快照。當使用者詢問「landing report」、「佇列中有什麼?」、「顯示開啟的 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"
# 共軛主機:AskUserQuestion 在此不可靠(原生已停用,MCP
# 變體不穩定),因此技能將決策以散文呈現,而非呼叫該工具。
# 僅在非 headless 時進行,使得在 Conductor (GSTACK_HEADLESS) 內部的 eval/CI 執行
# 仍然會封鎖(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, interactive),以避免後續每次執行都耗費資源。
_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"
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"
  echo "GSTACK_PLAN_MODE: active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
  export GSTACK_PLAN_MODE="active"
  echo "GSTACK_PLAN_MODE: active"
else
  export GSTACK_PLAN_MODE="inactive"
  echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
fi
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

計畫模式下的安全操作

在計畫模式下,下列操作是允許的,因為它們有助於制定計畫:$B、$D、codex exec/codex review、寫入 ~/.gstack/、寫入計畫檔案,以及用於產生 Artifacts 的 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 並遵循「內嵌升級流程」(如果已設定則自動升級,否則使用 4 個選項的 AskUserQuestion,如果拒絕則寫入延遲狀態)。

如果輸出顯示 JUST_UPGRADED <from> <to>:列印「執行中 gstack v{to}(剛剛更新!)」。如果 SPAWNED_SESSION 為 true,則跳過功能探索。

功能探索,每個會話最多一次提示:

  • 缺少 ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint:詢問 Continuous checkpoint 自動提交。如果接受,執行 ~/.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,則跳過。

首次執行引導(一次性)

如果 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(headless、非 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 的結尾:


## 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

…

[此處因翻譯而截斷]

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

相關技能