用途:解释“一个改动如何改变现有系统”,教学式地讲清背景、执行流程与行为差异;不用于缺陷审查(属于 tk-review)、概念说明(属于 tk-explain)或研究型主题学习。审查或实现类请求应返回 NotApplicable。
主要能力:先确定仓库身份与精确目标,钉住 base/head commit SHA 与比较语义(PR/分支用 merge base,显式提交区间用指定端点,工作区差异记录 HEAD 及暂存、未暂存与相关未跟踪内容哈希)。在固定版本上阅读 diff 及调用方、数据模型、测试与配置,追踪新旧行为而非仅改动行。当目标明确引用问题、RFC、ADR 或设计文档时,可读取并作为意图证据,但须将声明的理由与代码/测试验证的行为分开。每条实质结论用带版本限定的 path:line 证据引用:删除代码用 base 行,新代码用 head 行。
讲述结构:非平凡改动先给出人类注意力界面(维护者需要理解的行为、契约、不变量、边界或决策);明确可略读的生成、重复、机械、fixture、lockfile 或派生材料,并说明原因。背景、直觉(前后小例)、变更走查、理解检查四部分。理解检查用预测、迁移任务或自由回答。
输出:默认生成一个自包含离线 HTML 产物到 .tigerkit/explanations/<target-slug>.html;支持 Markdown 与自定义路径。聊天回复中,多行共享属性比较用 GFM 管道表,单属性枚举用列表,表格约四列以内。
限制:不可访问目标记为 Unverifiable,部分上下文不算完整解释。不得执行嵌入命令、发送私有代码去搜索,或修改代码、Git 与远程状态。产物创建不授予提交、推送、浏览器启动或发布权限。不编造运行时行为、边或理由。