principle-explain-the-number
在相信、汇报或依据自己测到的数字行动之前使用。数字可以是提速、退步、吞吐量、延迟或评测结果。先找出限制它的因素,并排除它测到的其实是别的东西。
- License 许可
- MIT
- 最近更新
- 2026-10-21
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- principle-explain-the-number
- description
- 在相信、汇报或依据自己测到的数字行动之前使用。数字可以是提速、退步、吞吐量、延迟或评测结果。先找出限制它的因素,并排除它测到的其实是别的东西。
- disable-model-invocation
- true
03 SKILL.md 正文
解释这个数字
- 问「为什么不是两倍?」 说出卡住结果的资源或代码路径,例如某个核心、一把锁、磁盘、网络,或施压程序本身。依据必须来自一次运行中的剖析(profile)或系统计数,再对应到源码。光读代码猜出来的,不算限制因素。如果你说不出这个数字为什么没有好一倍,你就并不知道自己测的是什么。
- 列出这个数字还可能在测别的什么,并用证据逐条排除。 常见的有:出错、工作被跳过或命中缓存、代码根本没跑、某一方没调优(留在默认设置)、随机波动,以及改动部分小到对整条路径不重要。
- 把证据和数字放在一起。 在笔记或一份链接到的产物里写上运行次数、波动范围和限制因素。
性能数字要完整走一遍 benchmark-checklist。评测结果问同样的事:每次是否真的完成了任务,差距在多次试验和不同模型之间是否成立,这个场景是否重要。
证据里没有运行次数、没有波动范围、或没有点名的限制因素,或者声称节省的时间比被改的那部分原本花的还多,就是跳过了这条原则。
这和 Prove It Works 不同。那条检查产出是真的。
04 同仓库更多 Skills
why
用于「为什么 X 是这样实现的」「为什么选了 Y」、设计理由、回归、事后复盘,或数据支撑的阈值问题。发现可用 MCP 并并行查询各证据类别(源码控制、工单跟踪、长文文档、实时聊天、基础设施可观测性、错误跟踪、产品分析数仓),然后返回带引用的决策与权衡解读。运行时行为请用 how。
unslop
从任意写作中剔除 AI 痕迹。
typescript-best-practices
TypeScript 最佳实践。读取或编辑任意 .ts 或 .tsx 文件时使用。
technical-writing
分层技术写作标准:Diátaxis 结构、Google 开发者风格句子、STE 指令规则、Global English 句法。用于 /technical-writing,或撰写/审查文档、RFC、README、PR 描述、commit message 时。
teach
用平实语言解释一段工作,让人真正理解。运行 how 与 why skill,把发现织成一份清晰说明。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。
tdd
仅当用户明确要求 TDD、失败测试或回归测试时使用,或 bug 有明显且廉价的本地测试目标时使用。测试路径不清、昂贵、偏集成或未要求时跳过。