Quiz Me 是一个用于检验真实理解程度的技能。它的职责是读取一个产物(代码差异、规格说明或计划),然后向用户提问以验证其是否真正理解,而不是替用户解释。这属于主动回忆,而非被动复习,目标是在缺口变成缺陷或错误实现之前将其暴露出来。
用途
在提交代码、开始构建或批准方案之前,通过提问确认用户对代码变更、规格或实现计划的真实掌握程度。尤其适合需要确保理解到位、避免盲目推进的场景。
主要能力
支持三种模式,根据上下文或用户请求自动判断:
代码模式(默认):读取 git 变更。默认使用 git diff HEAD(已暂存与未暂存);“last commit”或“previous commit”对应 git diff HEAD~1 HEAD;指定 SHA 对应 git diff <sha>~1 <sha>;“last N commits”对应 git diff HEAD~N HEAD;PR 编号则使用 gh MCP/插件。
规格模式:当用户提到 spec、设计文档或“在我实现之前”时触发。读取指定文件路径,或查找 docs/superpowers/specs/ 下最新的文件。问题聚焦数据模型决策、接口契约、范围边界与约束。
计划模式:当用户提到计划、实现计划或“架构决策”时触发。读取指定计划文件,或查找 docs/superpowers/plans/ 下近期的计划文件。问题聚焦为何选择该方案而非替代方案、步骤顺序、阶段之间的依赖关系以及风险。
如果来源不明确,会先询问用户要针对哪个产物出题,再继续。
使用方式
第一步,确定来源,按上述三种模式之一读取相应产物。第二步,仔细阅读产物并生成 5–7 道问题。好的问题需要思考,不能靠复制粘贴原文中的一行来回答。针对代码差异,问题可能涉及为何选择该方案而非更简单或不同的方案、移除某行或某块会破坏什么、遇到 null、空值或意外输入会怎样、迁移对现有数据有何改变、还会影响系统哪些其他部分。针对规格,问题可能涉及为何某个设计决策如此而非显而易见的替代方案、提供者协议的契约要求每个实现保证什么、什么在范围之外及原因、违反规格中的约束会怎样、组件 A 与组件 B 如何通信。针对计划,问题可能涉及为何第一阶段在此结束而不包含下一项、为何选择某架构决策而非你发现的替代方案、步骤 A 与步骤 B 之间的依赖能否颠倒、计划中最危险的假设是什么、若外部依赖不可用会最先破坏什么。问题深度会随产物规模调整,两行修复与完整系统设计的深度不同。
第三步,运行测验:一次问一个问题,等待回答,评分,再进入下一题,最后给出 X/Y 总结和一条观察。
评分标准
正确意味着理解“为什么”,而不仅是“是什么”。当思路正确但缺少重要细节时给予部分得分。不接受含糊回答,如果用户说“这样更高效”,会要求其具体说明。对于部分正确或错误回答,会追问一个暴露缺口的问题,而不是直接解释,让用户自行推理出答案;只有在其也答错追问时才揭示纠正。好的追问模式包括:“你说 X,那么当出现边界情况 Y 时会怎样?你的答案还成立吗?”“如果那是真的,某个具体场景会怎样?”“规格中关于你略过的那个点是怎么说的?”如果追问后仍未答对,给出简短纠正后继续,不做长篇说教。
语气
像严格但支持性的资深开发者,不是专门挑错的机器,而是希望用户成功。如果用户全部答对,会明确说明。
适用场景
适合在提交、构建或批准之前,对代码变更、规格说明或实现计划进行理解验证。尤其适合需要主动回忆、暴露理解缺口的开发流程。
限制
资料未提供关于收费、价格、平台支持范围、具体效果指标或安装步骤的信息,暂未提供。