Communitygithub.com

jpoindexter/theft-kit

只读队列仪表盘,用于感知工作区的航运管理。显示哪些VERSION槽位当前被开放的PR占用,哪些兄弟工作区有即将发布的WIP工作,以及/ship下一步会选哪个槽位。无修改操作——仅提供快照。当用户要求“着陆报告”、“队列里有什么”、“显示开放的PR”或“我下一步该认领哪个版本”时使用。(gstack)

theft-kit 是什么?

这是一个用于 gstack 版本队列管理的只读仪表盘技能,名为“着陆报告”(/landing-report)。它的核心功能是提供当前工作区的版本槽位(VERSION slots)占用情况快照,包括哪些槽位已被开放PR认领、哪些兄弟工作区有正在开发且可能很快发布的工作,以及执行 /ship 命令时会选择的下一个槽位。该技能基于 Shell 脚本运行,在执行主工作流之前会运行一个前置脚本(Preamble)来收集和输出大量上下文信息,如当前分支、会话、配置(proactive, skill_prefix, explain_level, checkpoint_mode 等)、学习记录、路由状态、是否嵌入(vendored)gstack 等。它支持在规划模式下安全执行,并包含一系列针对新用户或首次运行的引导交互(如询问遥测偏好、建议技能路由规则、特性发现提示等)。这些引导交互使用结构化的“AskUserQuestion”格式,提供决策简报(包含标题、项目背景、通俗解释、风险、推荐及利弊分析)。该技能适用于 Claude Code 等 AI 代理平台,但必须运行在安装了 gstack 工具链的环境中,且需要 AskUserQuestion 工具可用(否则技能被阻塞)。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/jpoindexter/theft-kit/tree/HEAD/landing-report

在你喜欢的 AI 中提问

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

文档

/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"
_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":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "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"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

规划模式安全操作

在规划模式下,允许以下操作(因为它们有助于制定计划):$B、$D、codex exec/codex review、写入~/.gstack/、写入计划文件,以及open生成的文件。

规划模式下的技能调用

如果用户在规划模式下调用技能,则该技能优先于通用的规划模式行为。将技能文件视为可执行指令,而非参考。 从步骤0开始逐步执行;第一个AskUserQuestion是工作流进入规划模式,而不是违反规划模式。AskUserQuestion(任何变体——mcp__*__AskUserQuestion 或原生;参见“AskUserQuestion 格式 → 工具解析”)满足规划模式的回合结束要求。如果没有可调用的变体,则技能被阻塞——停止并按照 AskUserQuestion 格式规则报告 BLOCKED — AskUserQuestion unavailable。遇到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 询问是否启用 Continuous checkpoint 自动提交。如果接受,运行 ~/.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 遵循 烧干大海原则——当 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 检查 Bug?

选项:

  • 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,则跳过。

如果 HAS_ROUTING 为 no 且 ROUTING_DECLINED 为 false 且 PROACTIVE_PROMPTED 为 yes: 检查项目根目录下是否存在 CLAUDE.md 文件。如果不存在,则创建它。

使用 AskUserQuestion:

当项目的 CLAUDE.md 包含技能路由规则时,gstack 工作得最好。

选项:

  • A) 将路由规则添加到 CLAUDE.md(推荐)
  • B) 不了,谢谢,我会手动调用技能

如果选择 A:在 CLAUDE.md 末尾追加以下内容:


## Skill routing

当用户的请求匹配可用技能时,通过 Skill 工具调用它。如有疑问,就调用技能。

关键路由规则:
- 产品创意/头脑风暴 → 调用 /office-hours
- 策略/范围 → 调用 /plan-ceo-review
- 架构 → 调用 /plan-eng-review
- 设计系统/计划审查 → 调用 /design-consultation 或 /plan-design-review
- 完整审查流程 → 调用 /autoplan
- Bug/错误 → 调用 /investigate
- QA/测试网站行为 → 调用 /qa 或 /qa-only
- 代码审查/差异检查 → 调用 /review
- 视觉润色 → 调用 /design-review
- 发布/部署/PR → 调用 /ship 或 /land-and-deploy
- 保存进度 → 调用 /context-save
- 恢复上下文 → 调用 /context-restore

然后提交更改:git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"

如果选择 B:运行 ~/.claude/skills/gstack/bin/gstack-config set routing_declined true 并告知他们可以通过 gstack-config set routing_declined false 重新启用。

此操作在每个项目中只发生一次。如果 HAS_ROUTING 为 yes 或 ROUTING_DECLINED 为 true,则跳过。

如果 VENDORED_GSTACK 为 yes,通过 AskUserQuestion 警告一次,除非 ~/.gstack/.vendoring-warned-$SLUG 已存在:

该项目在 .claude/skills/gstack/ 中嵌入了 gstack。嵌入已弃用。 迁移到团队模式?

选项:

  • A) 是的,立即迁移到团队模式
  • B) 不了,我会自己处理

如果选择 A:

  1. 运行 git rm -r .claude/skills/gstack/
  2. 运行 echo '.claude/skills/gstack/' >> .gitignore
  3. 运行 ~/.claude/skills/gstack/bin/gstack-team-init required(或 optional)
  4. 运行 git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode"
  5. 告知用户:“完成。每位开发者现在运行:cd ~/.claude/skills/gstack && ./setup --team”

如果选择 B:说“好的,您需要自行保持嵌入副本的最新状态。”

无论选择如何,始终运行:

eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}

如果标记文件已存在,则跳过。

如果 SPAWNED_SESSION 为 "true",则表示您在由 AI 编排器(例如 OpenClaw)生成的会话中运行。在生成的会话中:

  • 不要使用 AskUserQuestion 进行交互式提示。自动选择推荐选项。
  • 不要运行升级检查、遥测提示、路由注入或湖泊简介。
  • 专注于完成任务并通过散文输出报告结果。
  • 以完成报告结束:发布了什么、做出的决定、任何不确定的事项。

AskUserQuestion 格式

工具解析(请先阅读)

“AskUserQuestion”可以在运行时解析为两个工具:宿主 MCP 变体(例如 mcp__conductor__AskUserQuestion——当宿主注册时出现在您的工具列表中)或原生 Claude Code 工具。

规则: 如果您的工具列表中存在任何 mcp__*__AskUserQuestion 变体,请优先使用它。宿主可以通过 --disallowedTools AskUserQuestion(Conductor 默认这样做)禁用原生 AUQ,并将其路由到其 MCP 变体;那里调用原生方式会静默失败。相同的问题/选项形式;适用相同的决策简报格式。

如果您的工具列表中未出现任何 AskUserQuestion 变体,则此技能被阻塞。 停止,报告 BLOCKED — AskUserQuestion unavailable,并等待用户。不要将决策写入计划文件作为替代,不要将其作为散文输出并停止,也不要静默地自动决策(只有 /plan-tune AUTO_DECIDE 选择加入才授权自动选择)。

格式

每个 AskUserQuestion 都是一个决策简报,必须作为 tool_use 发送,而非散文。

D<N> — <一行问题标题>
项目/分支/任务:<1个简短的上下文说明句,使用 _BRANCH>
ELI10:<16岁少年能理解的通俗英语,2-4句话,说明利害关系>
选错的风险:<一句话说明会出什么问题、用户会看到什么、会损失什么>
推荐:<选项> 因为 <一行理由>
完整性:A=X/10, B=Y/10   (或:注意:选项在类型上不同,而非覆盖范围——无完整性评分)
优点/缺点:
A) <选项标签>(推荐)
  ✅ <优点—具体、可观察、≥40字>
  ❌ <缺点—诚实、≥40字>
B) <选项标签>
  ✅ <优点>
  ❌ <缺点>
净效果:<一行总结你实际在权衡什么>

D-编号:技能调用中的第一个问题是 D1;自行递增。这是一个模型级指令,而非运行时计数器。

ELI10 始终存在,使用通俗英语,不包含函数名。推荐功能始终存在。保留(recommended)标签;AUTO_DECIDE 依赖它。

完整性:使用 Completeness: N/10

Individual skills in this repo

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

jpoindexter/theft-kit

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

jpoindexter/theft-kit

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

jpoindexter/theft-kit

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

jpoindexter/theft-kit

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jpoindexter/theft-kit

Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.

相关技能