Communitygithub.com

charlieviettq/awesome-agent-skill

只读队列仪表盘,用于工作区感知的发布队列系统 (gstack)。

awesome-agent-skill 是什么?

该技能提供了一个只读的版本队列仪表盘,用于监控和管理基于 gstack 工作流的发布队列。它能够显示当前哪些 VERSION 槽位被打开的 PR 所占用,哪些同级的 Conductor 工作区有即将发布的 WIP 工作,以及下次 `/ship` 将选择哪个槽位。该技能支持多种 AI 代理平台(如 Claude Code、Cursor),通过读取本地 git 分支、gstack 配置和 Conductor 环境变量来生成报告。它仅执行读取操作,不会对队列或工作区进行任何修改。用户可以通过“landing report”、“what's in the queue”、“show me open PRs”或“which version do I claim next”等自然语言指令触发该技能。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.cursor/skills/gstack/deploy-ship/landing-report

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

何时调用此技能

显示哪些 VERSION 槽位 当前被开放的 PR 所占用,哪些同级的 Conductor 工作区有 很可能即将发布的 WIP 工作,以及下次 /ship 将选择哪个槽位。仅为快照,不执行任何修改操作。当用户询问“landing report”、“what's in the queue”、“show me open PRs”或“which version do I claim next”时使用。

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

Plan Mode 安全操作

在 plan 模式下,允许执行以下操作,因为它们为计划提供信息:$B、$D、codex exec/codex review、写入 ~/.gstack/、写入计划文件,以及 open 用于生成的产物。

Plan 模式下的技能调用

如果用户在 plan 模式下调用技能,则该技能优先于通用的 plan 模式行为。将技能文件视为可执行指令,而非参考。 从第 0 步开始逐步执行;第一个 AskUserQuestion 是工作流进入 plan 模式,并不违反 plan 模式。AskUserQuestion(任何变体——mcp__*__AskUserQuestion 或原生;参见“AskUserQuestion 格式 → 工具解析”)满足 plan 模式的回合结束要求。如果 AskUserQuestion 不可用或调用失败,则遵循 AskUserQuestion 格式失败回退:headless → 阻塞;interactive → 散文回退(也满足回合结束)。在 STOP 点,立即停止。不要在此处继续工作流或调用 ExitPlanMode。标记为“PLAN MODE EXCEPTION — ALWAYS RUN”的命令将继续执行。仅当技能工作流完成,或用户告诉您取消技能或离开 plan 模式后,才调用 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:使用 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 提示更简洁:第一次使用时包含术语解释、以结果为导向的问题、更短的散文。保持默认还是恢复简洁模式?

选项:

  • 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,或发现 bug 时建议 /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):根据 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 并运行(尽力而为),并标记为已激活:

~/.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:

当您的项目的 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

…

如果选择 B:运行 ~/.claude/skills/gstack/bin/gstack-config set routing_declined true。

如果 HAS_ROUTING 为 yes 或 ROUTING_DECLINED 为 true,则跳过。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能