SuperAPI AI 工具集

change-explainer-plain

编程与开发

查看项目

更新于 10-16 09:58

技能介绍

用途:把一组代码或文档变更讲给“冷读者”——假定对方懂普通编程和 Git,但不了解项目或文档的目的、领域、架构、术语与结构。可用一句明确的读者背景声明覆盖默认假设。

主要能力:按“整体→区域→具体问题→变更→机制→源码映射”搭建脚手架,讲解系统行为变化,而非语言语法、补丁机制或逐行改动;采用基线先于增量、具体先于抽象、先定义术语再使用的原则,挑选一到四个学习主线,按阅读顺序渐进展开。

使用方式:输出契约要求在最终回复中直接用 Markdown 给出完整讲解,不创建、保存或打开 HTML 页面、Markdown 文档、图表文件、.change-explainer/ 目录或其他产物。工作流保持只读;调用本技能仅授权查看,不授权修改仓库或所比较文档。若未指定目标且在 Git 仓库中,用 git status --short、已暂存与未暂存差异及相关未跟踪文件检查未提交工作;若工作树干净或目录不是 Git 仓库,则询问目标。

限制与说明:不主动提及缺少产物,除非这能消除用户请求中的歧义。仅在有助于理解时使用标题、列表、表格、短代码摘录或紧凑文本图,不输出原始 HTML 或依赖可折叠 UI。回答应随变更规模伸缩,小改动压缩为基线→示例→增量→证据,大改动先给概览再按行为分组分段。仅在有实质正确性、回归、契约、安全/数据或长期设计问题时添加 Concerns 段落。