Skills
简短的卡片,告诉智能体如何处理某一类反复出现的任务。是数据,绝不是代码——这里的内容不会被执行。
卡片更少,但每一张背后都有署名。这里的每张卡片在合并前都经过维护者评审,带着评审赋予的来源证明,并连同本页确切字节的哈希一起提供。这正是一个拥有九万条目的目录给不了的东西。
23 张卡片
定义 · 3
构建 · 4
chimera-budget-the-context
模式ai-agentsclean按低于真实窗口的预算来花,并把你每一步都重新发送的工具 schema 算进去——它们是压缩触及不到的地板。
chimera-carry-the-failure-forward
模式ai-agentsclean覆盖掉自己反馈变量的重试循环,只把第 2 次的失败展示给第 3 次——于是它又推导出第 1 次已经试过的那个补丁。
chimera-ground-it-in-the-source
模式software-devclean从已安装的版本里取签名,不要从记忆里取——一个看似合理的 API,在真正跑起来之前和真的没有区别。
derive-instead-of-transcribing
模式software-devclean任何从别处手抄过来的东西,只正确一次。能生成就生成,并在副本过期时让构建失败。
验证 · 7
assert-what-the-generator-found
模式software-devclean会崩溃的生成器告诉你它失败了;输出看似合理的生成器什么也没告诉你。测试它找到了什么,而不是它跑过了。
chimera-prove-the-test-discriminates
模式software-devclean一个你从没见它失败过的回归测试只是猜测。提交之前,把代码重新弄坏,看着它变红。
chimera-reproduce-before-diagnosing
模式software-devclean诊断是对一台你没有跑过的机器下的论断。先用一条简短的命令复现这次失败——尤其是当诊断来自别人的时候。
chimera-run-the-projects-own-gate-command
模式devopsclean原封不动地运行项目自己的验证命令——同样的范围,同样的参数。你临时改出来的那个几乎一样的变体,会在两个方向上都说谎。
chimera-test-the-wiring-not-the-class
模式software-devclean在测试里手工组装出来的类,只能证明这个类能用,证明不了有任何东西能走到它——要覆盖生产环境真正走的那条路径。
pin-the-case-that-narrowed-the-rule
模式software-devclean当一项检查打在错误的目标上,修复会让它变弱。在同一个提交里把这个误报固定成测试,否则规则会悄悄被磨掉。
verify-before-claiming
模式software-devclean在报告任务完成之前,先跑那个「若未完成就会失败」的检查——解释不是修复。
评审 · 5
chimera-give-the-denominator
模式researchclean不给出分母和构成的比率,每一位数字都是真的,却依然误导人——说出 n,并说清分子里有多少是本来就已知的噪声。
chimera-state-what-you-did-not-check
模式researchclean只根据系统的一部分做出的排名,读起来就像是对整个系统的排名——把范围和排除项写在结论旁边,而不是写在结论后面。
chimera-when-two-results-contradict-suspect-the-apparatus
模式researchclean当你自己的两次测量相差到没有任何机制能产生的幅度时,缺陷在仪器上。在此之上建立理论之前,先审查那套框架(harness)。
keep-the-caveat-with-the-number
模式researchclean数字和它的限定条件必须是同一个产物。两个段落会各走各的;一个组件做不到。
publish-the-run-that-did-not-work
模式researchclean把失败的实验也发出来,把被取代的那次原样保留,绝不为了显著性重跑。偏差在于挑选,不在于那个数字。
发布 · 4
build-the-gate-before-the-content
模式devopsclean在被守护的东西之后才加的检查,是有人为了发布而关掉的检查。趁还没有东西要拦,就把它接死。
chimera-list-exemptions-not-obligations
模式devopsclean列出要检查什么的门禁是失效即放行的——没人记得加进去的那个站点,正是会出问题的那个。改成列出豁免项,每一条都写明理由,默认就变成了失败。
do-not-ship-an-empty-surface
反模式software-devclean空的界面、标签页或分类,是产品没有兑现的承诺。有内容之前先藏起来,或者干脆先别做。
warn-before-the-thing-you-are-warning-about
模式software-devclean放在所涉动作之后的提醒,到达时读者已经做了决定。把它放在前面;重要的时候,别让它能被关掉。
贡献一张卡片
在产品仓库的 skills/ 目录发起一个 pull request。不需要先开 issue——这是开放区域,评审一张卡片是读一页文字,而不是审一份 diff。