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。