SuperAPI AI 工具集

create-handoff

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:在实现工作完成后生成结构化交接文档,为审查流程总结改动、风险和审查重点。

主要能力:根据上下文确定会话名(优先取用户传入参数并转为 kebab-case,否则从当前分支名推断;若在 main/master 则询问用户)。创建会话目录与交接文件路径 .chalk/reviews/${session_name}/handoff.md。若 handoff 已有超出模板的内容,会询问是覆盖还是新建带时间戳的会话。随后确定基线分支(依次尝试 main、origin/main、master、origin/master 的 merge-base),并收集上下文:git log --oneline、git diff --stat、git diff。

自动检测并运行项目检查:Node.js(按 yarn.lock、pnpm-lock.yaml、否则 npm 判断包管理器),运行 build、typecheck 或 npx tsc --noEmit、lint、test;Rust 运行 cargo check、cargo test --no-run、cargo clippy;Go 运行 go build、go vet、go test;Python 对改动的 .py 文件运行 py_compile,并只收集不运行 pytest;Make 运行 make build/check/test。无构建系统时注明“No build system detected — skipped automated checks”。检查失败只记录、不修复。

写入手握文件,格式含 Scope、What Changed、Files Changed、Risk Areas、Commands Run、Known Gaps、Suggested Focus For Reviewers 各节。最后向用户展示文件路径与摘要,并建议运行 /create-review。

限制:除交接文件外只读,不修改任何源代码;如实报告失败;文件列表须来自 git diff --stat 且不遗漏;若基线之前无提交,提醒用户没有可交接内容。收费、价格、平台支持等暂未提供。