best-practices

Installation
SKILL.md

Best Practices

标准是什么(为什么叫这个名字)

这个技能要求的是当前的最佳实践——现在被推荐、被采用的做法,而不仅仅是能跑通的答案。三者是不同的主张:

  • 正确 / 能跑通——编译通过,返回值正确。
  • 不过时——没有用到已废弃的东西。
  • 最佳实践 / 惯用法——是维护者和社区今天推荐的做法。

Agent 最容易在最高层悄悄翻车:代码能跑,就直接交付了,却建立在过时的 API 或非惯用的写法上。它通过了“对不对”,却没通过“现在该不该这样做”。补上这个差距就是这个技能的全部工作。 后面讲的所有内容——不轻信记忆、加倍下注陷阱、来源层级、搜索“推荐做法”而不是“随便一种做法”——都是达成这个目标的手段。技能的名字就是目标本身,不是一个标签。

为什么难,判断力体现在哪里

单靠记忆很难达到这个标准。训练知识有截止时间,在版本细节上容易模糊。在变化快的领域——框架、SDK、工具链、惯用法——你会自信地给出错误答案,而且通常自己意识不到。但解法不是“每次都搜索”(那样会污染上下文、拖慢流程、引入低质量内容)。解法是判断力:知道什么时候该怀疑自己,以及该去哪里、怎么核实。

这个技能就是这种判断力。它不是“去联网搜索”这句指令本身,那条原则已经存在于常驻规则里。它要解决的是模型容易出错的困难场景:预判自己的盲区,在被指出错误后体面地恢复,并确保最终落地的是当前的最佳实践,而不是搜到的第一个看似合理的结果。

什么时候该怀疑自己

Installs
2
GitHub Stars
12
First Seen
Jul 25, 2026
best-practices — liustack/vibemaster