Communitygithub.com

statsarthi — 読み取り専用キュー管理ダッシュボード

ワークスペース認識型の読み取り専用キュー管理ダッシュボード(gstack)です。現在どのバージョンスロットがオープンPRに使用されているか、どのConductorワークスペースが間もなく出荷されそうか、/shipが次にどのスロットを選択するかを表示します。

statsarthi — 読み取り専用キュー管理ダッシュボード とは?

statsarthi(正式名称:kelgirechandrakant-cpu/statsarthi)は、gstackベースのワークフローにおけるバージョンキュー管理ダッシュボードを提供するAIエージェントスキルです。このスキルは読み取り専用で、現在オープンなPRによってクレームされているバージョンスロット、進行中の作業(WIP)があるConductorワークスペース、そして/shipコマンドが次に選択するスロットを表示します。「ランディングレポートを見せて」「キューの中身を教えて」「どのバージョンを次にクレームすべきか」といったユーザーのリクエストに応答するよう設計されています。Claude Code、Codex、Cursor、Cline、Windsurf、Aider、Sourcegraph Codyなど、gstackがサポートするすべてのプラットフォームで動作します。スキルはPreambleセクションから実行を開始し、環境変数や設定ファイルを通じてワークスペースの状態を検出します。プランモードではスキルの指示が優先され、プロアクティブな提案(SKILL_PREFIX=trueの場合 /gstack-* 名前空間を使用)やアップグレードチェック、ユーザー設定のプロンプト(テレメトリ、プロアクティブモード、書き方スタイルなど)も行います。初回実行時にはプロジェクト固有のガイダンスが表示され、統計情報はローカルに蓄積されます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/landing-report

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

このスキルを呼び出すタイミング

どのVERSIONスロットが現在オープンPRによってクレームされているか、どの関連ConductorワークスペースがWIP(間もなく出荷されそうな作業)を持っているか、そして/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ホスト: 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"
_UPDATE_CHECK=$(~/.claude/skills/gstack/bin/gstack-config get update_check 2>/dev/null || echo "true")
echo "UPDATE_CHECK: $_UPDATE_CHECK"
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 "$HOME/.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"
for _RF in CLAUDE.md AGENTS.md; do
  if [ -f "$_RF" ] && grep -q "## Skill routing" "$_RF" 2>/dev/null; then
    _HAS_ROUTING="yes"
  fi
done
_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"
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 のままです。

UPDATE_CHECK が "false" の場合、次の2行をスキップします。更新チェックバイナリはそのモードでは何も出力しないため、UPGRADE_AVAILABLE / JUST_UPGRADED の出力はアクション対象になりません。

出力に UPGRADE_AVAILABLE <old> <new> が表示された場合:~/.claude/skills/gstack/gstack-upgrade/SKILL.md を読み、「インラインアップグレードフロー」(設定されていれば自動アップグレード、そうでなければ4つのオプションでAskUserQuestion、辞退した場合はスヌーズ状態を書き込み)に従います。

出力に JUST_UPGRADED <from> <to> が表示された場合:「Running gstack v{to} (just updated!)」と出力します。SPAWNED_SESSION がtrueの場合、機能発見をスキップします。

機能発見:セッションごとに最大1回のプロンプト:

  • ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint がない場合:Continuousチェックポイント自動コミットについてAskUserQuestion。受け入れられた場合、~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous を実行。常にマーカーファイルにtouchします。
  • ~/.claude/skills/gstack/.feature-prompted-model-overlay がない場合:「Model overlays are active. MODEL_OVERLAY shows the patch.」と通知。常にマーカーファイルに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) オフにする — 自分で /コマンド を入力します

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 の場合はスキップ。

初回実行ガイダンス(1回限り)

ACTIVATED が no(このマシンでの初回スキル実行)かつプリアンブルが空でない FIRST_TASK: 値を出力し、それが nongit ではない場合:トークンからマッピングされた、プロジェクト固有の短い1行をヘッズアップとして表示し、その後ユーザーが実際に要求したことを続行します。タスクを停止しないでください。トークンのマッピング: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(ヘッドレス、非git、またはアクション可能なものがない)の場合:何も表示せず、touch ~/.gstack/.activated 2>/dev/null || true のみ実行。

そうでなく、ACTIVATED が yes かつ FIRST_LOOP_SHOWN が no の場合:一度だけヘッズアップとして表示し(その後続行):

ヒント:gstackは1つのループを完了すると効果を発揮します — 計画 → レビュー → 出荷。一般的な最初のループ:/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を使用:

gstackは、プロジェクトのCLAUDE.mdにスキルルーティングルールが含まれているときに最も効果的に動作します。

オプション:

  • A) CLAUDE.mdにルーティングルールを追加する(推奨)
  • B) 結構です、スキルは手動で呼び出します

...(以降は翻訳のため省略)

Individual skills in this repo

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

関連スキル