SuperAPI AI 工具集

code-slice-explainer

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:对一个有边界的“切片”(请求、事件、功能动作、任务或数据项)做端到端讲解,不遗漏有意义的步骤。

主要能力:先说明进入的数据形态及其含义与来源;再按严格执行顺序走查,标出边界、分支点、共享与专用步骤、数据变换及变换原因;最后说明最终输出形态、去向与用途。还支持比较两个相关切片或新旧实现,比较触发、数据形态、执行顺序、边界、分支与输出差异。

使用方式:提供切片主题(功能、请求或事件、任务或工作流、流动中的数据、入口或路径)。可选 detail level(quick、standard、thorough,默认 standard)、focus(branch-heavy、data-shape-heavy、boundary-heavy、debugging-oriented)以及比较对象。输出按 Slice summary、Walkthrough、Diagram、Notes 的顺序组织,图中标出分支点与数据形态变化,并用简短注释说明。

限制:detail level 只改变讲解密度,不得省略有意义的步骤;路径不明确时指出歧义起点并说明最可能路径与备选分支;无法从代码证明的步骤应明确说明而非猜测。

另含校验方式:uv run --group dev python /Users/galew/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/code-slice-explainer,并保持 agents/openai.yaml 与最终触发措辞一致,可用 references/trigger-eval.md 审核描述覆盖度。具体细节见 references/ 下的输出契约、详细级别、图规则、比较工作流与示例提示。