用途：refresh-docs 用于增量更新逆向工程文档。它读取 docs/reverse-engineering/.stackshift-docs-meta.json 中记录的提交哈希，与当前 HEAD 对比，找出代码变更并只更新受影响的文档，避免全量重新生成。
主要能力：支持 smart（默认，仅增量更新受影响文档）和 full（通过 /stackshift.reverse-engineer 重新生成全部 11 份文档）两种模式。自动检测大范围变更（如超过 60% 源文件改动、package.json/go.mod 主版本升级、新增顶层目录、框架迁移）并建议 full 模式。按文件路径模式将变更映射到对应文档，例如 src/api/** 映射到 functional-specification.md、integration-points.md、data-architecture.md。更新后同步元数据与文档头部，并输出变更摘要。
使用方式：当用户说“更新逆向工程文档”“刷新文档”“同步文档与最新代码”等时触发。流程包括读取元数据并校验 git 状态、获取变更文件与提交摘要、映射变更到文档、按文档启动独立 Task 代理并行分析并精准编辑、验证更新、更新元数据与文档头部、展示摘要。
适用场景：已有逆向工程文档且代码发生变更，希望保持文档最新而不全量重生成时。
限制：需要存在元数据文件与有效 git 仓库；固定提交若被 rebase 或 force-push 丢失则回退到全量刷新；无 git 仓库无法增量更新；git 命令失败需报告并建议 git fetch --unshallow、git fsck 或全量刷新。大 diff（500+ 文件）需分批处理。具体收费、价格、平台等信息暂未提供。