clj-discover

Clojure 代码探索

使用不熟悉的 API 编写 Clojure 代码时，请先收集上下文。本技能侧重于 Java 互操作 和 宏。

何时使用本技能

遇到以下情况时，请自动使用本技能：

• 需要在 Clojure 中使用 Java 类
• 不清楚某个宏的行为（需要查看它会展开成什么）

工作流：Java 互操作

1. 先搜索 Clojure 封装库

直接探索 Java 类之前，先询问：

“我看到你正在使用 java.time.LocalDateTime。需要我搜索 Clojure 封装库吗？封装库通常能提供更简单、更符合惯用写法的 API。”

• “搜索封装库” → 使用 WebSearch 搜索 clojure wrapper for <library-name>
• “直接使用 Java” → 跳到下方的 Java 探索步骤

2. 探索 Java 类

如果直接使用 Java，请用 brepl 反射该类：

brepl <<'EOF'
(require '[clojure.reflect :as r])

; Get all public methods
(->> (r/reflect java.time.LocalDateTime)
     :members
     (filter #(instance? clojure.reflect.Method %))
     (map :name)
     sort)
EOF

记录以下发现：

• 可用的构造函数或工厂方法（例如 now()、of()）
• 重要方法及其返回类型
• 代码库中的常见模式

工作流：宏探索

使用宏时，请展开它们，以了解生成的代码：

brepl <<'EOF'
(macroexpand-1 '(your-macro args))     ; expand one level
(macroexpand '(your-macro args))       ; fully expand
EOF

宏展开可以揭示：

• 使用宏时实际运行的代码
• 隐藏的函数调用或副作用
• 宏的行为是否符合预期