SuperAPI AI 工具集

explain-like

设计与创作

查看项目

更新于 10-15 17:18

技能介绍

用途:将代码改动或设计文档分三个递进层次解释,确保理解并找出逻辑缺口。适用于两类场景:一是完成工作后解释分支/PR改动,验证表达是否清晰;二是写完设计文档后复述解释,发现遗漏。两者都服务于知识传递。

主要能力:始终同时生成三级解释。初学者(0-2年):基础概念、类比、"是什么"与"为什么";中级(5-10年):实现细节、模式、权衡;专家(10年以上):架构影响、边界情况、未来考虑。设计验证时,解释后列出发现的缺口或不一致。

用法:先确定对象,分支/PR改动则收集提交与差异,设计文档则读取指定文件。分支/PR可先执行: BASE=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo "main") git log --oneline $BASE..HEAD git diff $BASE...HEAD gh pr view --json title,body,commits 解释聚焦:解决什么问题、方案如何工作、为何选此方案。每级按固定结构组织(改动内容、重要性、关键概念;变更概览、实现方法、权衡;技术深入、架构影响、潜在问题)。

设计验证需追加验证发现:缺口、逻辑问题、疑问、建议。保存输出:设计文档在同一specs文件夹存为explanation.md;分支/PR存至specs/<feature-name>/explanation.md,无匹配spec时可询问是否创建。用户未明确要求前应先询问。语气分级:初学者耐心、用类比、少术语;中级专业、熟悉常见模式;专家简洁、聚焦非显然影响与边界。限制:资料未提供适用模型、平台或收费信息。