devkit-tool

统计报告里"占用大头"的分类桶，其名字多由关键词启发式生成、自带一个未经检验的定性。本 skill 在把裁剪/ROI/优化决策建到这个定性上之前做实证核实——全量导出桶内条目原文、按实际内容归类、用时间关联检验桶名暗示的成因；定性不成立时回数据层改名、按实证加权重算下游系数、留改正记录。当用户说"细化一下占用大头的明细""为什么这一项耗了这么多""这个分类里到底是什么""给听报告的人解释清楚"时使用。

带 submodule 的 Git 仓库同步拉取——父仓拉最新、子模块 checkout 到位、gitlink 对齐，是 `git pull` 增强版。与 `cascade-push` 配对但作用域相反：**只处理本仓直接声明的一层 submodule，绝不递归嵌套层**。诊断父仓/子模块/远端三方差异后由用户选拉取模式，移动 gitlink 前列新旧提交给用户确认。**仓库无 `.gitmodules` 时自动降级为普通 `git pull`，不询问模式。**

嵌套 git submodule（多层子模块）项目从最内层向外逐层提交推送，链式更新每一层父仓的 gitlink。push 前必出「推送简报」——逐层调查未提交改动（含 untracked）与待推送 commit（每条列 subject + 文件清单 + gitlink 标注），交 Human 批准后才带 --approved 推远端。自带 cascade-push.py：默认只出简报，--apply 才提交，--push --approved 才推送，push 后逐层写后回读远端 SHA。

再起一个 Claude Code 会话来干活——后台会话用 `claude --bg`（立即返回 8 位短 id，配 agents/attach/logs/stop 四个管理命令），要人盯着看的前台会话用两条 osascript 在 iTerm2 里弹新 tab。用户说「起一个后台会话/后台 agent」「并行开几个 claude 跑」「开个新 tab 跑 claude」「让另一个会话去做 X」「怎么看那个后台会话在干什么」「停掉那个后台会话」「claude --bg / claude agents / claude attach / claude logs / claude stop 怎么用」「claude logs 出来一堆乱码转义」「新开的 tab 跑在错的目录里」「pgrep iTerm2 查不到进程」时使用。**起会话之前就读**，别等 cwd 落错仓或 logs 刷出满屏 ANSI 才来。派活给一个**已经存在**的会话是另一件事，走 ListAgents + SendMessage。

判断一个仓库该不该建 codegraph 代码知识图谱、什么时候建、worktree 要不要各自建，以及建完怎么用（含实测的体积/耗时/内存阈值与已验证的坑）。codegraph 是 tree-sitter 抽符号 + 调用边存本地 SQLite 的代码图，不是文档知识图谱。本 skill 只用 CLI，明令禁止接 MCP。

查看/读取第三方依赖（Maven jar、node_modules）源码，定位版本差异或第三方行为导致的 bug；不分析本仓库自有代码。区别于 key-module-analysis（只分析本仓库自有模块）。

从 Claude Code 会话 transcript（~/.claude/projects 下 jsonl）复现一份「需求全流程耗时与 ROI」报告——九脚本流水线把散在多会话/多 worktree 的动作重放成统一口径的有效工时账（日历折算、subagent 并集计入、阶段由门禁事件切窗），产出交互式 HTML 时间轴（阶段两层构成/步骤证据/未具名分解）与 md 数据底稿，外加三档对比（现状/保守可达/理想上限）与裁剪面分析。当用户说"分析这个需求花了多久""AI 全流程耗时/ROI 报告""这条轨的时间都花在哪了""复现那次耗时分析"时使用。

初始化/更新**整个代码库**的 AI 上下文：生成根级 CLAUDE.md（守 200 行）+ .claude/rules/project/{topic}.md（横切规则，自动加载，用 paths frontmatter 条件生效）+ 模块级 CLAUDE.md；分阶段遍历并回报覆盖率，可增量续跑。区别于 key-module-analysis（只深挖单个已锁定的关键模块出深度文档包，不生成 CLAUDE.md）。

对一个已锁定的关键模块（非整个仓库）做深度分析，产出 9 份结构化文档包（模块卡片/边界/运行时流程/依赖契约/风险热点/ADR/运维手册/变更影响清单/关键流程图），支撑架构梳理、重构规划、故障预防、AI 辅助变更安全。区别于 init-architect（扫描整仓生成 CLAUDE.md，不产出这套深度文档包）。

拉取 Claude Code 已配置的插件市场(marketplace)最新代码，刷新已启用插件(enabled plugin)的本地缓存版本(含 user scope 与 project/local scope 两种安装范围)，并在刷新后回收缓存磁盘占用。先探测再刷新，只动真有变化的那几个。

查找与清理游离的 Claude Code 子进程——用 run_in_background 启动、因会话压缩/清屏/重启丢失 Task 句柄但仍在运行的后台服务。仅适用于 Linux/WSL（GNU ps/pstree 语法）：macOS 上 `ps --ppid`、`ps -o cmd`、`pstree` 均实测不可用，macOS 场景不要套用本 skill。

把因自定义模型配置（第三方 API 中转 / 本地 LLM）而回不到 Claude 订阅鉴权的会话切回订阅。定位三层污染源（shell 环境变量 / settings 文件的 env 段 / daemon 进程继承），用 `--settings` 空串覆盖起新会话替换旧会话，并自动沿用旧会话的显示名，全程保住对话历史。判据落在 transcript 的实际应答模型上，不信"看起来切过去了"。仅 macOS 实证。

把当前话题画给用户看——按要讲的东西挑最小够用的那一种视图：伪代码、调用树、组件树、文件树、Mermaid 图、diff、整块代码，或一个聚焦的 HTML 产物（图解／信息图／短幻灯）。当用户说"画出来""画个图""给我看看结构""这块怎么跑的""可视化一下""图解一下""show me"，或你正要用一大段散文去解释结构、流程、状态变化、重构前后差异时使用。