SuperAPI AI 工具集

duck-explain

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

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)。
  • 解释优先,仅在用户要求或解释揭示需要时才升级到其他技能。

其他信息

该技能的官方文本暂未提供。