duck-explain 是一个以“解释模式”为核心的技能,目标是把本地复杂性转化为即时理解。它强调快速解读、低仪式感,并始终开启“原始人模式”(caveman mode always on),即用最直白的语言表达。
用途
该技能用于快速解释代码、日志、查询或配置。当用户提出“解释这个”、“这是什么……”等需求时适用。它不负责根因排查、架构决策、代码审查或测试规划,这些分别交给 duck-debug、duck-design、duck-review、duck-triage 等技能处理。
主要能力
- 固定四段式输出:What(当前字面行为)、Why(在系统中的可能意图)、Watch out(1-2 个具体风险或陷阱)、Next question(一个能解锁下一步的问题)。
- 长度控制:默认总长 8-16 行;快速模式(用户要求“快速解释”或“tl;dr”)压缩到 4-8 行。
- 输入类型:接受粘贴的代码/日志/查询/配置、文件路径加符号/函数/类、堆栈跟踪片段。若未提供具体材料,会先问一个问题以获取目标。
- 分析方法:识别执行角色(入口点、转换器、验证器、副作用、编排器);解释输入/输出的数据形态(或前后状态);指出一个不变量/假设;指出尖锐边缘(顺序、可空性、重试、隐藏耦合)。
使用方式
用户直接提供需要解释的材料即可。若材料不具体,技能会先询问目标。输出始终遵循四段式格式,并根据用户是否要求快速模式调整长度。
适用场景
- 快速理解一段陌生代码的行为与意图。
- 解读日志、查询或配置的含义。
- 在调试或设计前先获得基础理解。
限制
- 不负责根因排查或处理不稳定行为(应转向 duck-debug)。
- 不负责架构/权衡决策(应转向 duck-design)。
- 不负责 PR/diff 发现和内联评论(应转向 duck-review)。
- 不负责覆盖率缺口、严重性和测试计划(应转向 duck-triage)。
- 不提供完整教程、示例和渐进式教学(应转向 duck-teach)。
- 解释优先,仅在用户要求或解释揭示需要时才升级到其他技能。
其他信息
该技能的官方文本暂未提供。