Technical Change Tracker
概述
Technical Change Tracker 用于跟踪每一次代码变更,采用结构化 JSON 记录并生成可访问的 HTML 输出,目标是让 AI 机器人会话在上一会话过期或被放弃后仍能无缝恢复。
适用时机
- 需要在多次 AI 编码会话之间进行结构化变更跟踪时使用。
- 当机器人会话在任务中途过期,下一次会话需要完整上下文才能继续时使用。
- 当接手的项目缺乏变更历史记录、需要补充时使用。
工作方式
状态机:
planned -> in_progress -> implemented -> tested -> deployed | +-> blocked
命令:
/tc init | /tc create | /tc update | /tc status | /tc resume | /tc close | /tc export | /tc dashboard | /tc retro
会话交接:每个 TC 都会存储进度摘要、后续步骤、阻塞项、关键上下文以及正在进行中的文件,使下一次机器人会话能够从上次中断处精确接续。
非阻塞:TC 的记录工作通过后台子代理运行,不会打断编码工作。
功能特性
- 结构化 JSON 记录,带有仅追加(append-only)的修订历史。
- 测试用例可附带日志片段作为证据。
- 输出符合 WCAG AA+ 的无障碍 HTML(深色主题、基于 rem 的字体)。
- 纯 CSS 实现的仪表板,支持按状态筛选。
- 仅使用 Python 标准库,零外部依赖。
- 可通过 /tc retro 从 git 历史进行回溯式批量创建。
完整仓库
https://github.com/Elkidogz/technical-change-skill —— MIT License
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为针对特定环境的验证、测试或专家评审的替代。
- 如果缺少必要的输入、权限、安全边界或成功标准,应停止并请求澄清。