SuperAPI AI 工具集

duck-explain

编程与开发

查看项目

更新于 10-16 03:37

技能介绍

用途:把局部复杂度变成即时理解,适合用户要求解释代码、日志、查询、配置、函数/文件行为或片段流程时使用。通常输出四段:What 说明当前字面行为,Why 推测系统意图,Watch out 给出1-2个具体风险或坑,Next question 提一个能推动下一步的问题。默认长度8-12行、约110-160词,每段一到两句;用户说“quickly explain”或“tl;dr”时压缩到4-6行;仅当用户要求更深入讲解或材料涉及多个耦合关注点时才展开。

方法:识别执行角色(入口、转换、校验、副作用、编排),说明输入输出数据形态或前后状态,指出一个不变量或假设,点名尖锐边缘(顺序、可空性、重试、隐藏耦合)。若用户问“如何修改”,优先按阶梯建议:复用本地实现 → 标准库/原生 → 已安装依赖 → 自定义;涉及实现时保持建议最小化,并保留信任边界校验、安全控制、防数据丢失、可访问性要求和用户明确需求等核心保障。

限制:无具体材料时先问一个定位问题;上下文不完整时问1-3个澄清问题;证据缺失时明确说明假设。本模式不编辑代码、不执行工具操作,需要实现前必须获得用户明确同意并改派。若涉及根因排查或偶发行为转 duck-debug,架构/取舍转 duck-design,PR/差异审查转 duck-review,覆盖率与测试计划转 duck-triage,完整教程转 duck-teach。解释优先,仅在用户要求或解释暴露需要时才升级。共享保障继承自 references/GUARDRAILS.md。