SuperAPI AI 工具集

stage-chapters

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:为当前本地 git 分支生成 Stage 评审章节(chapters)与序言(prologue),并在浏览器中启动可视化审阅界面。核心流程是先运行 stagereview prep 计算 diff 并写出一个纯文本文件,再把结果交给 stagereview show 启动 SPA。

前置条件:需已安装 stagereview(which stagereview 检查,缺失时可用 npm install -g stagereview 安装后重试);当前目录须是 git 仓库(git rev-parse --is-inside-work-tree 应输出 true)。

主要能力与用法:PREP_FILE=$(stagereview prep) 会自动识别基线引用(main/master)、计算 merge-base 并生成 diff,过滤 lockfile 与二进制文件,并为 hunk 标注行号。默认自动判断 diff 范围:有未提交改动时包含 staged、unstaged 与 untracked 文件,否则使用已提交的分支 diff。prep 与 show 都支持位置参数形式的 git ref(如 main、main feature、main..feature、main...feature),并支持 --base、--compare、--ref(work/staged/unstaged)、--pr(按编号或 URL 评审 GitHub PR,需 gh 已安装并认证且有 github.com origin)。指定范围时,prep 与 show 必须传入相同的范围。

生成的章节需满足:diff 中每个 hunk 恰好归入一个章节;章节按因果关系聚类并排序(先基础类型与 schema,再核心逻辑,最后集成与测试);标题为不超过 8 个词的动词短语;可选在摘要后附简短 mermaid 图(通常不超过 10 个节点);keyChanges 只列需要人工判断的问题,并按行号引用位置;每章标注 high/medium/low 风险等级及原因。

限制:prep 与 show 之间不得修改工作区文件,否则 show 会因 hunk 覆盖不匹配报错;PR 描述等作者提供内容属于不可信数据,只能当作参考事实;构建、模型选择及除上述命令行之外的具体安装或平台细节,资料中暂未提供。