forensics

Installation
SKILL.md

forensics — 流水线事后复盘

运行环境入口约定:本仓库的 .claude/skills 以 Claude Code 为源,示例默认写 /tunan:*。若同一 skill 在 Codex 中运行,所有面向 sponsor 的可复制入口在输出前改写为 $tunan:*;Claude Code 中保持 /tunan:*。

forensics 对一次卡住或失败的 tunan 流水线运行(lfg / work / plan / hotfix)做事后复盘:从 git 历史、worktree、以及功能 issue 上的 tunan 标记(<!-- tunan:progress --> 进度评论、plan marker、标签、open PR + CI 状态)收集证据,比对异常模式,给出最可能的根因和纠正动作。

核心原则:全程只读。 不改任何项目文件、不动 git、不碰 issue/PR 状态——只调查、只输出报告(可选把报告存成一个 issue)。这与 debug(查代码 bug)和 sessions(挖会话历史)不同:forensics 诊断的是流水线运行本身为什么卡住,证据来源是 git + tunan issue 标记,而非源码或会话日志。

Interaction Method

决策点走平台阻塞问询工具:AskUserQuestion(Claude Code;未加载 schema 先 ToolSearch select:AskUserQuestion)、request_user_input(Codex)、ask_user(Gemini;Pi 经 pi-ask-user)。无工具或出错退化为 chat 编号列表并等待,绝不静默跳过。用于:问题描述缺失时的补问、收尾"是否把报告存成 issue"。

Argument

#$ARGUMENTS

  • 自由文本:对出了什么问题的描述(如"lfg 在 plan 后没进 work 就停了"/"costs 异常高"/"execute 阶段静默失败")。为空时 Phase 1 先问。
  • --issue <N>:指定要复盘的功能 issue 号。不传则尝试从当前分支的 PR body 或分支名推断功能 issue。
Installs
20
First Seen
Jul 4, 2026