菜单
Use when you want a read-only view of the current stacked-PR chain — which branches are in the stack, their PR numbers and states (OPEN, MERGED, CLOSED), and which branches have diverged from their parent and need a restack. Renders the full tree without touching any branch or remote.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | stack-status |
| description | Use when you want a read-only view of the current stacked-PR chain — which branches are in the stack, their PR numbers and states (OPEN, MERGED, CLOSED), and which branches have diverged from their parent and need a restack. Renders the full tree without touching any branch or remote. |
| when_to_use | Reach for this before deciding whether to restack or submit — it tells you exactly where divergence is so you can act on facts, not guesses. Also useful after a teammate merges upstream changes and you want to see the blast radius before running restack. Do NOT use to push or restack — stack-status is read-only; use /stack-submit or /stack-restack instead. |
| context | fork |
| agent | Explore |
| allowed-tools | ["Bash(git *)","Bash(gh *)","Read"] |
| scheduling | user wants to know the current state of a stacked-PR chain (branch names, PR numbers, divergence) without modifying any branch or remote |
| structural | ["Locate the stack graph for this repo via stack-discovery.sh","Enrich each branch with live PR number and state from gh","Compute divergence for each branch against its parent","Render the tree with DIVERGED flags where divergence > 0"] |
| logical | tree is printed with every branch in the stack, its PR number/state, and a DIVERGED flag on every branch whose git merge-base count > 0; no writes occur |
Show the full stacked-PR chain for the current repo: branch names, PR numbers, open/merged/closed states, and divergence warnings wherever a branch has drifted from its parent.
/stack-status
No arguments needed. The skill reads the local stack graph and queries GitHub for live PR state.
bash plugins/stack-flow/skills/_lib/stack-discovery.sh
stack-discovery.sh reads stack-graph.json from ${CLAUDE_PLUGIN_DATA:-$(pwd)/.claude}/stack-flow/<repo-key>/, enriches each branch entry with gh pr view output, and computes divergence via stack-graph.sh diverged. It then emits the tree to stdout.
main
└── feat-auth [PR #42: OPEN]
└── feat-auth-tests [PR #43: OPEN] [DIVERGED: parent 2 ahead, branch 1 ahead]
└── feat-auth-docs [PR #44: OPEN]
Each line shows:
[DIVERGED: ...] tag when stack-graph.sh diverged <branch> returns a non-zero commit count — this branch needs /stack-restack before its PR can merge cleanlybash plugins/stack-flow/skills/_lib/stack-discovery.sh and capture stdoutmain or master)[DIVERGED: ...] — list them for the usergh is unavailable, note that PR state is omitted and the tree still shows branch structure and divergence flagsInput: Stack with three branches, all in sync.
Output:
main
└── feat-login [PR #10: OPEN]
└── feat-login-ui [PR #11: OPEN]
└── feat-login-tests [PR #12: OPEN]
Input: Stack where feat-login-ui has fallen behind its parent after a teammate pushed to feat-login.
Output:
main
└── feat-login [PR #10: OPEN]
└── feat-login-ui [PR #11: OPEN] [DIVERGED: parent 3 ahead, branch 1 ahead]
└── feat-login-tests [PR #12: OPEN] [DIVERGED: parent 3 ahead, branch 0 ahead]
stack-discovery.sh exits with a message explaining the file was not found; no tree is printed.gh auth is expired, PR state is omitted from the tree and a warning is printed; branch structure and divergence flags still render from local git data.Use when the user describes a multi-step feature or refactor and you need to decide whether to handle it solo, dispatch a parallel `/fan-out`, or run a `/worktree-team` planner→generator→reviewer pipeline. Outputs a routing recommendation with the reasoning behind it.
Use whenever the user asks to apply the same operation to many independent files or components — bulk migration, batch refactor across controllers, parallel exploration of unrelated subsystems. Dispatches one subagent per file with a shared prompt template, then collects the results.
Use to toggle the safe-mode flag at .claude/safe-mode. The flag is written automatically by consecutive-failure-guard once tool failures hit FORGE_SAFE_MODE_THRESHOLD (default 5), and block-destructive.sh denies every Bash/Write/Edit while it exists. /safe-mode off clears the flag, logs the exit, and prompts /postmortem; /safe-mode on enters manually; /safe-mode status reports current state.
Run the 5-stage Token Transformation Pipeline (TRAE §5.2.2) over the current session state — Collection, Ranking, Compression, Budgeting, Assembly. Emits a concrete next-action recommendation (/compact, /lean-md, or /progress-log + fresh session) instead of a generic warning.
Audit or scaffold a CLAUDE.md against the Karpathy 4-section structure (Think Before Coding · Simplicity First · Surgical Changes · Goal-Driven Execution). Companion to /lean-md — structure audit, not size trim.
Print every policy enforcement point declared in plugins/diagnostics/registry/policies.json — id, verdict, plugin, hook event, severity, bypass — grouped by verdict. Single discoverable index of what the harness blocks, anchors, nudges, or logs at runtime.