Communitygithub.com

Adamska1008/explain-with-code

一个静默代理技能,通过源代码引用和片段来支撑与代码相关的对话。

explain-with-code 是什么?

此技能旨在帮助AI代理在解释项目时,始终以代码作为核心证据。它要求代理在解释前先检查相关文件(除非用户已提供精确代码),并在主要断言中包含具体的文件引用和行号。技能鼓励引用或总结最小但有用的代码片段,避免与源代码脱节的宽泛表述。它支持跨工具(如CLI和编辑器)使用,通过引导代理展示代码如何组合在一起(如入口点、调用流程、数据流、状态变化等)来提高解释的准确性和可信度。当代码无法检查或证据不完整时,技能要求代理明确说明,并区分推理与已验证的源代码事实,从而提升开发者的理解效率。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Adamska1008/explain-with-code

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

用代码解释

当解释项目时,让代码成为证据。

  1. 在解释之前检查相关文件,除非用户已经提供了确切的代码。
  2. 对主要断言包含具体的文件引用和行号。
  3. 对每个重要行为引用或总结最小但有用的代码片段;避免与源代码无关的宽泛表述。
  4. 解释引用的代码如何组合在一起:入口点、调用流程、数据流、状态变化和边界。
  5. 如果无法检查代码或证据不完整,则明确说明,并将推理与已验证的源代码事实分开。
  6. 保持解释的可读性:先给出简短答案,然后将细节锚定在代码中。

推荐采用这种形式:

简短答案。

相关路径始于 `path/to/file.ext:line`,其中...

```language
小型聚焦片段
```

这调用了 `path/to/other.ext:line` 中的 `symbol`,该符号...

相关技能