古法编程

使用结构化 JSON 记录 AI 编程的代码变更轨迹

解决 AI 编程中的“失忆”问题：通过结构化记录每次代码变更，让 AI 能够通过状态机追踪进度，确保即使在会话过期或更换 Bot 后也能立即恢复工作上下文。

为什么需要这个技能

在使用 AI 进行复杂的功能开发时，最头疼的是会话长度限制（Context Window）导致的记忆丢失，或者在一次长会话中断后，新会话需要花费大量 Token 重新同步进度。

传统的 Git Commit 虽然能记录变更，但缺乏“意图”和“当前状态”的细粒度描述。本技能通过建立一套结构化的 JSON 记录机制，将开发状态（如：计划中 → 执行中 → 已测试 → 已部署）显式化，使 AI 能够像接力赛一样，在不同会话间无缝传递进度、阻碍点和下一步计划。

适用场景

  • 长周期开发任务：需要跨越多个 AI 会话完成的大型功能模块。
  • 会话中断恢复：当 Bot 会话由于超时或崩溃需要重启时，快速同步至上次停止的确切位置。
  • 缺乏文档的项目接手：通过 /tc retro 指令从 Git 历史中追溯变更，快速构建结构化的变更历史文档。
  • 团队协作同步：将 AI 的执行状态以可读的 HTML 仪表盘形式分享给其他开发者。

核心工作流

1. 状态机驱动

所有变更遵循严格的状态流转，确保过程可追溯： planned (计划) → in_progress (执行中) → implemented (已实现) → tested (已测试) → deployed (已部署)。 若遇到问题，则流转至 blocked (阻塞) 状态。

2. 核心指令集

通过一套标准命令管理变更记录：

  • /tc init：初始化追踪环境。
  • /tc create / /tc update：创建或更新变更记录。
  • /tc status / /tc dashboard：查看当前进度及可视化面板。
  • /tc resume：恢复之前的会话上下文。
  • /tc retro：根据 Git 历史追溯性创建记录。

3. 会话接力（Handoff）

每个记录均包含：进度摘要、后续步骤、阻塞因素、关键上下文及正在处理的文件。新会话启动后，AI 直接读取 JSON 记录，无需用户手动粘贴之前的聊天记录。

下载和安装

下载 technical-change-tracker 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐