Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

一个只读的队列仪表盘,用于感知工作区感知型项目(gstack)的版本发布状态。

Tony-Claude-Code-Skills 是什么?

此技能为 Claude Code、Cursor 或 Codex 等 AI 代理提供了一个名为 `/landing-report` 的只读版本队列仪表盘。它能够显示当前哪些版本 slot 已被开放的 PR 占用、哪些相关工作区有即将发布的进展,以及下次 `/ship` 操作会选择哪个 slot。该技能非常适合用于回答“发布报告”、“队列中有什么”、“显示我的 PR”或“下一步我应该申请哪个版本”等自然语言问题。它支持 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 工作区有 WIP 工作很可能即将发布,以及下次 /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"
# Conductor 主机:此处 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,交互式),以便后续每次运行都不在热路径上。
_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(当计划模式激活时由 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-* 名称。磁盘路径保持为 ~/.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>:打印“正在运行 gstack v{to}(刚刚更新!)”。如果 SPAWNED_SESSION 为 true,则跳过功能发现。

功能发现,每个会话最多一个提示:

  • 缺少 ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint:针对持续检查点自动提交的 AskUserQuestion。如果接受,运行 ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous。始终 touch 标记。
  • 缺少 ~/.claude/skills/gstack/.feature-prompted-model-overlay:通知“模型叠加已激活。MODEL_OVERLAY 显示补丁。”始终 touch 标记。

升级提示后,继续工作流。

如果 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.

相关技能