SuperAPI AI 工具集

watzup

通用与其它

查看项目

更新于 11-06 10:09

技能介绍

watzup 是 easy-claude 工具集中的实用收尾技能,定位为“交接而非编辑”:只审阅、总结和标记,不修改仓库中任何文件。

用途:在一次 AI 编码会话结束或工作流要求时,向开发者交付有证据支撑的会话总结,让读者理解做了什么、为什么这样做、最终如何运行,并据此决定下一步。

主要能力:

  1. 界定会话范围——收集未提交的工作区改动(git status、git diff、git diff --staged)以及本次会话产生的提交,并结合任务列表、计划和提示词台账(tmp/prompt-ledger)确定边界。
  2. 四段式会话摘要——按顺序输出 Done(完成事项,映射到用户请求或会话目标)、Key changes(按区域分组并附 file:line 锚点)、Why(决策与取舍)、How it works(改动后的行为或流程),随后补充逐文件细节、影响与质量评估。
  3. 文档过时检查——将改动路径与对应文档(hooks、skills、workflows、服务规格、前端参考文档、CLAUDE.md 等)交叉比对,列出可能过时的文档并说明原因,不代为修改。
  4. 规格驱动健康检查——仅在业务代码发生改动时运行:检查业务规格根目录是否存在 Feature Specs,并将改动的业务行为映射到规格所有者,给出 MATCH、DRIFT 或 NOT VERIFIED 结论。
  5. AI 错误与教训分析——每次运行必做,梳理会话中的错误,提取通用根因规则(去掉项目专有名称),仅在通过价值门槛且用户确认后才建议用 $learn 持久化。
  6. 生成 HTML 会话报告——将四部分内容加标记与下一步写入 tmp/reports/watzup-{YYMMDD}-{HHmm}-{slug}.html,基于 references/session-report-template.html 模板,通过 node .claude/scripts/open-report.cjs <path> 打开,并在对话中给出简短摘要和报告路径。

使用方式:当工作流步骤或用户提出 HTML 会话总结需求时触发;按声明的步骤顺序执行,每步开始与结束更新待办跟踪状态,每个完成或跳过的步骤附简要证据或跳过原因;步骤顺序未经用户批准不得跳过、重排或合并。最后用原生提问工具询问下一步。

适用场景:编码会话收尾、需要向他人交接工作上下文、需要检查文档与规格是否落后于代码、希望从会话失误中沉淀可复用教训。

限制:严格只读,唯一写入是 git 忽略的会话报告;不编辑、不修复、不实现、不更新被标记的文档或规格;无代码改动时文档与规格健康检查记录为跳过并附证据;教训持久化需用户明确确认;报告中所有主张需可追溯证据与置信度。