SuperAPI AI 工具集

recap-doc

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

用途:在功能开发完成后生成本轮改动回顾(walkthrough)文档,面向需要了解改动内容与原因的用户。命令签名为 /recap-doc --scope <json-path-or-inline> [--focus <str>] [--depth brief|normal|deep] [--output <path>],其中 --scope 为必填,接受 ScopeReport JSON 文件路径、- 标准输入或以内联 JSON 字符串。

主要能力:先加载并校验 ScopeReport v1(version、source、files、feature_context、fallback_trace);若 scan_error !== false 则报告并走 Need Human 退出;再收集 git 证据(git log、git diff --stat、读取前 N 个改动文件);若存在技术规格则做规格与实现的漂移比对;逐文件调用 /codex-explain 解释;合成 Overview、Changed Files、Design Decisions、Spec vs Implementation Drift、Blind Spots、Anticipated Questions、Evidence 各节;写入前调用 security-redact.js 做密钥脱敏。

深度档位:brief 取前 5 个文件、盲点仅前 3、无预判问题、无代码片段;normal 取前 10、完整盲点、至少 3 个预判问题;deep 取前 15 并内联代码片段。默认输出到系统临时目录 <tmp>/sd0x-dev-flow-recap/briefing-recap-<YYYY-MM-DD>.md,需长期保存时用 --output 显式指定且目标必须位于仓库根或临时目录内。

限制:不适用于交互问答(用 /recap-ask)、完整流程(/post-dev-recap)、技术分享(/tech-brief)、单函数解释(/codex-explain)或已有文档的第一性原理推理(/fp-brief)。性能目标为从加载范围到写文件不超过 30 秒(不含外部 LLM 延迟)。