SuperAPI AI 工具集

repo-migration

写作与研究

查看项目

更新于 10-16 03:34

技能介绍

Repo Migration 是一个面向学术研究场景的仓库迁移技能,来源为 vincenzoimp/academic-research-skills。它的目标是在不丢失来源信息(provenance)的前提下,把混乱的研究仓库整理成可理解、可维护的结构。

用途 该技能用于迁移杂乱的学术研究仓库,包括下载的归档、提案文件夹、临时笔记本、脚本、数据集或论文素材。它强调第一遍迁移的重点是让仓库变得可理解,而不是立即改进科学质量。

主要能力

  • 快照当前状态:使用 git status --short 和文件清单记录仓库现状。
  • 文件分类:将文件归类为来源、数据、代码、笔记本、输出、报告、配置、凭据、生成缓存或未知。
  • 目录重组:把不可变的研究来源移入 sources/、reports/ 或 data/raw/;把可重复代码移入 src/,把轻量入口移入 scripts/;仅在笔记本属于探索性或叙述性内容时保留在 notebooks/。
  • 输出分离:区分可信、探索、训练、分析和调试输出。
  • 来源记录:为重要论文、提案和数据集添加来源台账行和 wiki 页面。
  • 问题记录:把未解决问题写入 wiki/open_questions.md,而不是进行猜测。
  • 结构校验:运行仓库结构检查和测试。

使用方式 技能说明中列出了应先阅读的参考文件:references/repository-contract.md、references/repo-migration-policy.md、references/output-contracts.md。随后按上述工作流逐步执行。

适用场景 适用于需要整理学术研究仓库、归档、提案、笔记本、脚本、数据集或论文素材的场景,尤其是希望保留来源信息、区分不同可信度输出、并建立可追溯记录的情况。

限制与禁止事项

  • 在结构迁移过程中不得重写科学逻辑,除非为保持测试可运行所必需。
  • 未经用户批准不得删除可疑文件。
  • 不得在未复现的情况下将仅存在于笔记本的结果提升为最终结论。
  • 迁移过程中需保留:重命名时的原始文件名(记录在台账备注中)、归档路径与解压路径、提案版本、命令历史(如存在)、数据来源与访问限制。

其他信息 该技能的官方文本、具体安装命令、收费方式、支持平台及实际效果等事实暂未提供。