SuperAPI AI 工具集

lesson-learned

编程与开发

查看项目

更新于 10-15 20:21

技能介绍

用途:从真实的代码改动中提取具体、有依据的软件工程经验教训,用用户自己的代码作为镜子,展示其中已经体现或可改进的做法。

主要能力:先加载经验原则参考文件,再确定分析范围;支持按功能分支、最近 N 次提交、指定提交或未提交的工作区改动进行分析;通过 git log 与 git diff 收集改动,必要时先用 --stat 概览再挑选改动最多的文件细读;识别主导模式,关注结构决策、权衡取舍、解决的问题与被错过的改进机会,并映射到 se-principles.md 中的具体原则。

使用方式:开始前读取 references/se-principles.md,可选读取 references/anti-patterns.md。范围判断上,在功能分支时用 git log main..HEAD --oneline 与 git diff main...HEAD;在主分支时默认分析最近 5 次提交,用 git log --oneline -N 与 git diff HEAD~N..HEAD;指定提交用 git show <sha>;查看未提交改动用 git diff 与 git diff --cached。呈现时按“课程名称、代码中发生了什么、体现的原则、为什么重要、下次的启示”模板输出,最多额外补充 2 条,总数不超过 3 条。

适用场景:提交前复盘、分支合并前的经验提炼、团队或个人对近期改动的学习总结。

限制:只分析改动涉及的文件,不读取整个仓库;改动超过 500 行时先看统计再选择性精读;改动过于琐碎时应如实说明不必强行总结;语气为反思性而非指令性,避免“你本应该”式表达,先肯定有效做法再提改进建议。该技能的收费、价格、平台等信息暂未提供。