---

name: technical-change-tracker description: "使用结构化JSON记录跟踪代码变更，状态机强制执行，以及AI会话交接以保持机器人连续性" category: development risk: safe source: community source_repo: Elkidogz/technical-change-skill source_type: community date_added: "2026-04-05" author: Elkidogz tags: [change-tracking, session-handoff, documentation, accessibility, state-machine] tools: [claude, cursor, gemini, codex]

技术变更追踪器

概述

使用结构化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记录，带有仅追加的修订历史
• 测试用例，带有日志片段证据
• WCAG AA+可访问的HTML输出（深色主题、基于rem的字体）
• 纯CSS仪表板，带有状态过滤器
• 仅使用Python标准库 — 零外部依赖
• 通过 /tc retro 从git历史批量追溯创建

完整仓库

https://github.com/Elkidogz/technical-change-skill — MIT许可证

限制

• 仅当任务明确匹配上述描述的范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。