SuperAPI AI 工具集

coauthor-brief

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:为多作者、多机器项目生成一份协作者交接简报(Markdown),让合作者或换机器后的自己几分钟内了解改了什么、各产物状态、被阻塞项、如何本地运行流水线,以及新合作者所需的受限数据访问步骤。它面向“别人接手”,与面向自己续做的 /checkpoint 互补。

主要能力:确定变更窗口(--since 指定 tag、ISO 日期或 Ndays;否则取 quality_reports/handoffs/ 中最近简报的日期;再否则回退 14 天并注明);只读收集 git 变更(git log、git diff --stat、当前分支、并行分支)、可复现性护照状态、计划与日志中的阻塞项、环境锁文件(renv.lock、requirements.txt、environment.yml、uv.lock、Stata 版本与 ssc install 列表)及受限数据访问流程;按模板写出简报,状态须标注 measured(附命令)或 inferred,委派任务逐项给出 done/in progress/blocked/not started。

使用方式:调用 /coauthor-brief,可用 --since <tag|date|Ndays> 指定基线,--for <name> 针对特定合作者定制。结果写入 quality_reports/handoffs/YYYY-MM-DD_coauthor-brief.md(目录不存在则创建;--for 时文件名加后缀),并在对话中打印保存路径、变更窗口、统计与数据段是否包含。

适用场景:发送仓库或 PR 前让合作者快速上手;新 RA/合作者入职;长期多作者项目定期同步;跨机器交接。

限制:不推送、不建 PR、不合并;不运行流水线或复核数字;不生成环境锁文件;不暴露受限数据,只描述获取流程。若无法解析 since 且窗口内无 git 历史,仍写出简报并注明“窗口内无变更”;检测到受限数据仓库但缺少 confidential-data.md 时,数据段留 TODO 占位并警告,不猜测访问流程。