← 返回开发时间线

开发时间线同步:版本缺口 - 自动同步系统

建立了个人开发时间线自动同步系统:脚本检测版本缺口 + Git hook 提醒 + Agent skill 按流程生成条目。

2026-07-20

熊窝架构

建立了个人开发时间线自动同步系统:脚本检测版本缺口 + Git hook 提醒 + Agent skill 按流程生成条目。

组件

  • scripts/sync-timeline.py:遍历 6 个站点 git log,按完整版本号(major.minor.patch)检测时间线缺口,支持 —json 输出供 Agent 消费
  • scripts/git-hooks/post-commit:每次 personal 仓库提交后自动检测版本缺口并打印提示
  • ~/.agents/skills/sync-timeline/SKILL.md:Agent 工作流规则,按文件变更量自动选择精简或详细 body 风格

设计决策

  • 比较逻辑从按 (major,minor) 分组改为按完整版本号比对所有已存在版本,不再遗漏中间版本(如 v0.3.1 → v0.4.2 之间的 v0.4.1)
  • Git hook 只在 personal 仓库触发,不扩散到所有站点
  • 条目正文由 Agent 根据 git diff 分析生成:≤10 文件精简摘要,>10 文件结构化 Markdown
  • 新站点先列出所有版本让用户确认,再批量导入
  • 脚本只改 data.js,不自动 commit / push

首次同步

运行 sync-timeline.py 后一次性补全 20 条缺失版本,覆盖全部 6 个站点,时间线从 33 条扩至 53 条。