Communitygithub.com

charlieviettq/awesome-agent-skill

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

awesome-agent-skill 是什麼?

此技能提供一個唯讀的版本佇列儀表板,用於 `gstack` 工作流程。在使用者提出「著陸報告」、「佇列中有什麼」、「顯示我開啟的 PR」或「我接下來該索取哪個版本」等請求時,自動觸發。它能顯示哪些 VERSION 插槽已被開啟的 PR 佔用、哪些相關的 Conductor 工作區正在進行即將發佈的工作,以及下次執行 `/ship` 時會挑選哪個插槽。此技能僅用於檢視快照,不會對系統進行任何修改。它相容於 Claude Code、Cursor 和 Codex 等平台,並透過一系列 shell 指令收集環境資訊(如 Git 分支、工作階段類型、功能開關設定)來準備報告。執行過程中,它會處理升級提示、功能探索(如持續檢查點和模型覆蓋層)以及首次執行引導(包括專案偵測和寫作風格偏好設定)。此技能也支援規劃模式,確保在規劃階段能安全執行,同時尊重使用者的自訂設定,如 `proactive` 和 `skill_prefix` 旗標。

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

在你喜歡的 AI 中提問

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

說明文件

何時呼叫此技能

顯示哪些 VERSION 插槽 目前被開啟的 PR 佔用、哪些相關的 Conductor 工作區有 即將發佈的進行中工作,以及下次 /ship 會挑選哪個插槽。僅供 檢視 — 不進行任何修改。當有人要求「著陸報告」、「佇列中有什麼」、「顯示我開啟的 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 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

規劃模式安全操作

在規劃模式下,允許以下操作,因為它們能為計劃提供資訊:$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 個選項,如果拒絕則寫入延後狀態)。

如果輸出顯示 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,或對錯誤建議 /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(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 1 individual skill — each has its own dedicated page.

相關技能