用途：为代码修改建立可审计的结构化记录。每条技术变更（TC）记录包含改了什么、为何改、谁改、何时改、如何测试以及下一步进展，以 JSON 形式存放在目标项目的 docs/TC/ 下，并按严格 schema 与状态机校验。适用于需要变更审计、跨 AI 会话交接、结构化发布说明或为既有项目补建变更文档的场景；不适用于仅从 git 历史生成 changelog、仅跟踪技术债，或拼写与格式等不影响行为的琐碎改动。
主要能力：TC ID 采用 TC-NNN-MM-DD-YY-slug 格式，子 TC 为 TC-NNN.A 或 TC-NNN.A.N；状态机为 planned -> in_progress -> implemented -> tested -> deployed，并支持 blocked 与返工/热修回退。记录含追加式 revision_history（R1、R2…）与 test_cases（T1、T2…），历史只增不改。会话交接块位于 session_context.handoff，含 progress_summary、next_steps、blockers、key_context、files_in_progress、decisions_made。校验器强制状态机合法性、ID 顺序、审批一致性（approved=true 需 approved_by 与 approved_date）、TC ID 格式，并采用原子写入（先写 .tmp 再重命名），每次写注册表时重算统计。
使用方式：先初始化 python3 scripts/tc_init.py --project "My Project" --root .；再创建 python3 scripts/tc_create.py --root . --name "user-authentication" --title "Add JWT-based user authentication" --scope feature --priority high --summary "Adds JWT login + middleware" --motivation "Required for protected endpoints"；更新用 tc_update.py（如 --set-status in_progress --reason "Starting implementation"、--add-file src/auth.py:created、--handoff-progress/--handoff-next）；查看用 tc_status.py（--tc-id 或 --all --json）；校验用 tc_validator.py（--record 或 --registry）。脚本均为仅标准库的 Python，支持 --help 与 --json。仓库还提供 /tc 斜杠命令分发 init、create、update、status、resume、close、export、dashboard。
限制与注意：记录会提交进仓库，不应写入密钥；不要直接编辑 tc_record.json，应使用 tc_update.py；不要复用已删除的 TC ID；避免每个文件建一条 TC，应按逻辑单元（功能、修复、重构）建一条；更新宜在里程碑由后台子代理完成，避免打断主流程。具体安装方式与更多细节暂未提供。