SuperAPI AI 工具集

lesson-learned

通用与其它

查看项目

更新于 10-16 09:59

技能介绍

用途:从真实的代码变更中提炼具体的软件工程经验教训,而不是空泛说教。适用于用户提出“这里有什么经验教训”“我能从……学到什么”之类的请求。

主要能力:按分支、最近 N 次提交、指定提交或未提交的工作区改动来确定分析范围,读取提交信息与 diff,识别主导模式,并映射到参考中的工程原则。分析维度包括结构决策、权衡取舍、解决的问题以及可改进之处。

使用方式:先加载 references/se-principles.md,必要时读取 references/anti-patterns.md,再确定范围。范围对应的 git 命令:功能分支用 git log main..HEAD --oneline 加 git diff main...HEAD;最近 N 次提交用 git log --oneline -N 加 git diff HEAD~N..HEAD;指定提交用 git show <sha>;工作区改动用 git diff 加 git diff --cached。默认在功能分支上比对 main,在主分支上分析最近 5 次提交。diff 超过 500 行时先用 git diff --stat,再选择性阅读改动最多的 3 到 5 个文件。只读变更文件。

输出:按模板给出课程名称、代码中发生了什么、起作用的原则、为什么重要、下次的可行建议;可另加最多 2 条补充教训,总计不超过 3 条。语气反思而非规训,以用户代码为证据。改动过于琐碎时应如实说明,不强行提炼。

限制:不列出所有沾边的原则,不分析未变更的文件,不忽视提交信息,不给脱离代码的抽象建议,不只给负面反馈。官方资料未提供安装命令、收费与平台信息。