尧图网页设计 
用 GitHub Copilot 驱动 Joyride在 VS Code 用户空间中用 REPL 驱动的 ClojureScript 自动化【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot导读本文讲解如何利用本仓库提供的 Copilot 自定义指令instructions/joyride-user-project.instructions.md让 GitHub Copilot 化身为一名精通 Joyride 的 Clojure 交互式编程专家。Joyride 是一款运行在 VS Code Extension Host 中的 SCI ClojureScript 环境可完整访问 VS Code API读完本文你将掌握以 REPL 求值为核心的交互式编程工作流能够使用 Joyride Core API、promesa 异步模式、扩展 API 与 Joyride FlaresWebView在用户空间中逐步构建、验证并落地 VS Code 自动化脚本。Joyride 与用户空间自动化背景与定位Joyride 是 VS Code 的自动化扩展其核心模型是在用户空间运行 ClojureScriptSCI 解释执行Joyride 基于 SCISmall Clojure Interpreter在 VS Code 的 Extension Host 进程中运行 ClojureScript无需编译步骤即可执行完整 VS Code API 访问通过vscode模块的互操作语法直接调用window、commands、workspace、extensions等命名空间下的方法与成员用户项目 vs 工作区自动化本仓库同时提供两份互补的指令——joyride-user-project.instructions.mdapplyTo: **面向任意项目中的 Joyride User Script 工程与 joyride-workspace-automation.instructions.mdapplyTo: **/.joyride/**面向.joyride/目录下的工作区专属自动化。前者即本文主题关注脚本与src目录下的用户工程代码。在本仓库中的使用方式本仓库是一个社区贡献的 Copilot 指令、Agent、Skill 与配置集合见 README.md。按 docs/README.instructions.md 的说明你可以点击指令表中的安装按钮或下载*.instructions.md文件放入工作区的.github/instructions/目录如.github/instructions/joyride-user-project.instructions.md指令会自动应用于 Copilot 行为。此外仓库中的 skills/first-ask/SKILL.md 与 skills/boost-prompt/SKILL.md 都以joyride_request_human_input工具为动力展示了 Joyride 在 Skill 场景下的真实集成形态。核心哲学交互式编程REPL-Driven Development指令给 Copilot 定义的第一原则是REPL 是超级武器。Copilot 的主工具是Joyride evaluation——直接在 VS Code 运行时环境中求值代码并验证而不是给出纯理论建议。具体工作方式逐步迭代拿到问题陈述后与用户一起一步一步推进每次求值一个小表达式不一定是完整函数验证其行为符合预期使用以(in-ns ...)开头的代码块展示在 Joyride REPL 中实际求值的内容只在用户要求时才更新文件优先用 REPL 把功能求值出来。指令还强调一套数据导向的 Clojure 风格约束优先编写接收参数、返回结果的纯函数副作用仅作为服务更大目标的最后手段函数参数优先使用解构destructuring与 map优先使用命名空间化关键字可用:foo/something这类合成命名空间对数据分组建模数据时扁平优于嵌套强烈不鼓励使用println以及js/console.log——应通过求值子表达式来测试而不是打印输出。最后一条经验法则任何 API 用法在写入文件前都先到 REPL 中验证。入门检查项目与信息源在动手前Copilot 被指示先查看项目的README.md以及scripts、src目录中的代码。对于更全面的 Joyride 信息指令建议在具备fetch_webpage工具时查阅官方提供的两份 LLM 上下文指南agent 技术指南与用户协助指南——后者涵盖项目结构、常用模式、示例与故障排查。始终与用户、REPL 和文档三方确认再迭代推进。核心 API 与互操作语法加载命名空间用joyride.core/load-file而非load-fileClojure 内置的load-file在 Joyride 中并未实现应使用 Joyride 的异步版本(joyride/load-file) ; 异步接受绝对路径或相对工作区的路径返回 promise命名空间定位至关重要使用 Joyride evaluation 工具时务必指定正确的命名空间参数。若函数定义未定位到目标命名空间可能落入错误的命名空间如user导致在预期位置不可用。VS Code API 访问通过vscode模块直接互操作(require [vscode :as vscode]) ;; Common patterns users need (vscode/window.showInformationMessage Hello!) (vscode/commands.executeCommand workbench.action.files.save) (vscode/window.showQuickPick #js [Option 1 Option 2])互操作语法要点函数与成员使用vscode/api.method形式不要实例化 JS 类而是直接使用普通 JS 对象例如#js {:role user :content ...}。Joyride Core API 速查符号说明joyride/*file*当前文件路径(joyride/invoked-script)正在运行的脚本在 REPL 中为 nil(joyride/extension-context)VS Code 扩展上下文(joyride/output-channel)Joyride 的输出通道joyride/user-joyride-dir用户 joyride 目录路径joyride/slurp类似 Clojureslurp但为异步接受绝对路径或相对工作区路径返回 promisejoyride/load-file类似 Clojureload-file但为异步接受绝对路径或相对工作区路径返回 promise异步操作处理awaitResult 参数evaluation 工具提供awaitResult参数来管理异步操作awaitResult: false默认立即返回适用于同步操作或即发即弃fire-and-forget的异步求值awaitResult: true等待异步操作完成后返回结果即返回 promise 的解析值。应使用awaitResult: true的场景需要读取用户输入结果的对话框showInputBox、showQuickPick需要结果的findFiles、readFile等文件操作返回 promise 的扩展 API 调用带按钮的信息消息需要知道点击了哪个按钮。保持默认awaitResult: false的场景同步操作、简单的信息消息等即发即弃调用、不需要返回值的副作用型异步操作。Promise 处理用 promesa 编排异步Joyride 的异步模型依赖 promise指令推荐使用promesa.core(require [promesa.core :as p]) ;; Users need to understand async operations (p/let [result (vscode/window.showInputBox #js {:prompt Enter value:})] (when result (vscode/window.showInformationMessage (str You entered: result)))) ;; Pattern for unwrapping async results in REPL (use awaitResult: true) (p/let [files (vscode/workspace.findFiles **/*.cljs)] (def found-files files)) ;; Now found-files is defined in the namespace for later use ;; Yet another example with joyride.core/slurp (use awaitResult: true) (p/let [content (joyride.core/slurp some/file/in/the/workspace.csv)] (def content content) ; if you want to use/inspect content later in the session ; Do something with the content )注意其中先求值再def固化结果的模式把异步结果解包后存入命名空间中的 def便于在当前会话后续引用与检查。安全访问其他扩展的 API自动化常常需要读取其他扩展的能力。指令给出了先检查、再使用的防御性模式;; How to access other extensions safely (when-let [ext (vscode/extensions.getExtension ms-python.python)] (when (.-isActive ext) (let [python-api (.-exports ext)] ;; Use Python extension API safely (- python-api .-environments .-known count)))) ;; Always check if extension is available first (defn get-python-info [] (if-let [ext (vscode/extensions.getExtension ms-python.python)] (if (.-isActive ext) {:available true :env-count (- ext .-exports .-environments .-known count)} {:available false :reason Extension not active}) {:available false :reason Extension not installed}))要点getExtension可能返回 nil未安装扩展对象上要用.-isActive检查是否已激活导出 API 通过.-exports访问——例如上述 Python 示例最终返回一个扁平、自描述的 map{:available ... :reason ...}正是指令推崇的数据导向风格。Joyride Flares创建 WebView 与侧边栏视图Flares 是 Joyride 提供的一种便捷方式用于创建 WebView 面板与侧边栏视图并支持通过 REPL 与之交互。基本用法(require [joyride.flare :as flare]) ;; Create a flare with Hiccup (flare/flare! {:html [:h1 Hello World!] :title My Flare :key example}) ;; Create sidebar flare (slots 1-5 available) (flare/flare! {:html [:div [:h2 Sidebar] [:p Content]] :key :sidebar-1}) ;; Load from file (HTML or EDN with Hiccup) (flare/flare! {:file assets/my-view.html :key my-view}) ;; Display external URL (flare/flare! {:url https://example.com :title External Site})注意flare!返回 promise调用时应使用awaitResult: true。关键点Hiccup 样式:style属性使用 map如{:color :red :margin 10px}文件路径支持绝对路径、相对路径要求处于工作区内或 Uri 对象生命周期管理(flare/close! key)、(flare/ls)、(flare/close-all!)双向消息通过:message-handler与post-message!实现 WebView 与 REPL 之间的双向通信。指令同时提醒当演示创建状态栏按钮这类可驻留 UI 的一次性对象时务必持有该对象的引用以便后续修改与 dispose释放。常用用户模式脚本执行守卫Script Execution Guard这是最基础的守护模式——保证代码只在作为脚本被调用时执行而在 REPL 中加载时不误触发;; Essential pattern - only run when invoked as script, not when loaded in REPL (when ( (joyride/invoked-script) joyride/*file*) (main))原理即前文 API 表中的invoked-script被调用的脚本REPL 中为 nil与*file*当前文件路径二者比对。管理 Disposables统一注册到扩展上下文事件订阅等返回的 disposable 必须纳入扩展上下文的 subscriptions随扩展生命周期统一释放;; Always register disposables with extension context (let [disposable (vscode/workspace.onDidOpenTextDocument handler)] (.push (.-subscriptions (joyride/extension-context)) disposable))可视化展示结果与文件编辑指令要求 Copilot 在演示能力时以可视化方式呈现结果例如统计或汇总后用信息消息showInformationMessage展示结果生成 Markdown 文件并以预览模式打开更进阶的做法创建并打开一个 WebViewFlare通过 Joyride REPL 与之交互。文件编辑则遵循同样的原则优先用 REPL 开发确需编辑文件时优先使用结构化编辑工具structural editing tools而非直接改字面文本。从源码视角印证Joyride 在仓库 Skill 中的实际形态本仓库虽不包含 Joyride 扩展本体源码但其 skills/first-ask/SKILL.md 与 skills/boost-prompt/SKILL.md 是 Joyride 工具在实际 Skill 中集成的可运行证据first-askSkill 声明Requires the Joyride extension其工作流完全由joyride_request_human_input工具驱动——在refining阶段反复向人类开发者询问范围、交付物、约束确认无更多输入后再展示计划、建立 todo list 并开工boost-promptSkill 同样在需要澄清细节时调用joyride_request_human_input。从源码结构看可以推断这类joyride_*工具正是 Joyride 向 Copilot/Agent 暴露REPL 求值 请求人工输入能力的两面前者把 ClojureScript 表达式的求值结果交回对话流对应本文的 evaluation/awaitResult机制后者把对话暂停权交给用户。这也解释了为何指令反复强调命名空间定位与异步结果处理——它们是工具正确工作的前提。使用限制与适用前提本文所有 API 均以 Joyride 在 VS Code Extension Host 中运行 SCI ClojureScript 为前提需已安装 Joyride 扩展joyride_request_human_input等工具仅在对应扩展就绪时可用first-askSkill 明确标注了这一依赖load-file、slurp等均为异步实现并返回 promise需配合 promesa 与awaitResult: true使用不能按 Clojure 同步语义调用命名空间参数必须显式指定否则函数会落入错误命名空间涉及外部扩展如ms-python.python的访问必须先检查安装与激活状态示例中展示的是防御式访问而非假设 API 一定存在。小结这份指令把 GitHub Copilot 塑造成以 REPL 为超级武器的 Joyride 专家从命名空间加载、VS Code API 互操作、Joyride Core API到awaitResult与 promesa 的异步编排、扩展 API 的安全访问、Flares WebView 创建以及脚本执行守卫与 disposable 管理两大高频模式构成了一条逐步求值、就地验证、最后落地的完整开发闭环。配合仓库中的 joyride-workspace-automation.instructions.md面向.joyride/工作区自动化与依赖 Joyride 工具的 first-ask、boost-prompt 两个 Skill你可以把同一套 REPL 驱动方法论从个人用户脚本扩展到团队共享的项目级自动化。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 GitHub Copilot 驱动 Joyride：在 VS Code 用户空间中用 REPL 驱动的 ClojureScript 自动化
用 GitHub Copilot 驱动 Joyride在 VS Code 用户空间中用 REPL 驱动的 ClojureScript 自动化【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot导读本文讲解如何利用本仓库提供的 Copilot 自定义指令instructions/joyride-user-project.instructions.md让 GitHub Copilot 化身为一名精通 Joyride 的 Clojure 交互式编程专家。Joyride 是一款运行在 VS Code Extension Host 中的 SCI ClojureScript 环境可完整访问 VS Code API读完本文你将掌握以 REPL 求值为核心的交互式编程工作流能够使用 Joyride Core API、promesa 异步模式、扩展 API 与 Joyride FlaresWebView在用户空间中逐步构建、验证并落地 VS Code 自动化脚本。Joyride 与用户空间自动化背景与定位Joyride 是 VS Code 的自动化扩展其核心模型是在用户空间运行 ClojureScriptSCI 解释执行Joyride 基于 SCISmall Clojure Interpreter在 VS Code 的 Extension Host 进程中运行 ClojureScript无需编译步骤即可执行完整 VS Code API 访问通过vscode模块的互操作语法直接调用window、commands、workspace、extensions等命名空间下的方法与成员用户项目 vs 工作区自动化本仓库同时提供两份互补的指令——joyride-user-project.instructions.mdapplyTo: **面向任意项目中的 Joyride User Script 工程与 joyride-workspace-automation.instructions.mdapplyTo: **/.joyride/**面向.joyride/目录下的工作区专属自动化。前者即本文主题关注脚本与src目录下的用户工程代码。在本仓库中的使用方式本仓库是一个社区贡献的 Copilot 指令、Agent、Skill 与配置集合见 README.md。按 docs/README.instructions.md 的说明你可以点击指令表中的安装按钮或下载*.instructions.md文件放入工作区的.github/instructions/目录如.github/instructions/joyride-user-project.instructions.md指令会自动应用于 Copilot 行为。此外仓库中的 skills/first-ask/SKILL.md 与 skills/boost-prompt/SKILL.md 都以joyride_request_human_input工具为动力展示了 Joyride 在 Skill 场景下的真实集成形态。核心哲学交互式编程REPL-Driven Development指令给 Copilot 定义的第一原则是REPL 是超级武器。Copilot 的主工具是Joyride evaluation——直接在 VS Code 运行时环境中求值代码并验证而不是给出纯理论建议。具体工作方式逐步迭代拿到问题陈述后与用户一起一步一步推进每次求值一个小表达式不一定是完整函数验证其行为符合预期使用以(in-ns ...)开头的代码块展示在 Joyride REPL 中实际求值的内容只在用户要求时才更新文件优先用 REPL 把功能求值出来。指令还强调一套数据导向的 Clojure 风格约束优先编写接收参数、返回结果的纯函数副作用仅作为服务更大目标的最后手段函数参数优先使用解构destructuring与 map优先使用命名空间化关键字可用:foo/something这类合成命名空间对数据分组建模数据时扁平优于嵌套强烈不鼓励使用println以及js/console.log——应通过求值子表达式来测试而不是打印输出。最后一条经验法则任何 API 用法在写入文件前都先到 REPL 中验证。入门检查项目与信息源在动手前Copilot 被指示先查看项目的README.md以及scripts、src目录中的代码。对于更全面的 Joyride 信息指令建议在具备fetch_webpage工具时查阅官方提供的两份 LLM 上下文指南agent 技术指南与用户协助指南——后者涵盖项目结构、常用模式、示例与故障排查。始终与用户、REPL 和文档三方确认再迭代推进。核心 API 与互操作语法加载命名空间用joyride.core/load-file而非load-fileClojure 内置的load-file在 Joyride 中并未实现应使用 Joyride 的异步版本(joyride/load-file) ; 异步接受绝对路径或相对工作区的路径返回 promise命名空间定位至关重要使用 Joyride evaluation 工具时务必指定正确的命名空间参数。若函数定义未定位到目标命名空间可能落入错误的命名空间如user导致在预期位置不可用。VS Code API 访问通过vscode模块直接互操作(require [vscode :as vscode]) ;; Common patterns users need (vscode/window.showInformationMessage Hello!) (vscode/commands.executeCommand workbench.action.files.save) (vscode/window.showQuickPick #js [Option 1 Option 2])互操作语法要点函数与成员使用vscode/api.method形式不要实例化 JS 类而是直接使用普通 JS 对象例如#js {:role user :content ...}。Joyride Core API 速查符号说明joyride/*file*当前文件路径(joyride/invoked-script)正在运行的脚本在 REPL 中为 nil(joyride/extension-context)VS Code 扩展上下文(joyride/output-channel)Joyride 的输出通道joyride/user-joyride-dir用户 joyride 目录路径joyride/slurp类似 Clojureslurp但为异步接受绝对路径或相对工作区路径返回 promisejoyride/load-file类似 Clojureload-file但为异步接受绝对路径或相对工作区路径返回 promise异步操作处理awaitResult 参数evaluation 工具提供awaitResult参数来管理异步操作awaitResult: false默认立即返回适用于同步操作或即发即弃fire-and-forget的异步求值awaitResult: true等待异步操作完成后返回结果即返回 promise 的解析值。应使用awaitResult: true的场景需要读取用户输入结果的对话框showInputBox、showQuickPick需要结果的findFiles、readFile等文件操作返回 promise 的扩展 API 调用带按钮的信息消息需要知道点击了哪个按钮。保持默认awaitResult: false的场景同步操作、简单的信息消息等即发即弃调用、不需要返回值的副作用型异步操作。Promise 处理用 promesa 编排异步Joyride 的异步模型依赖 promise指令推荐使用promesa.core(require [promesa.core :as p]) ;; Users need to understand async operations (p/let [result (vscode/window.showInputBox #js {:prompt Enter value:})] (when result (vscode/window.showInformationMessage (str You entered: result)))) ;; Pattern for unwrapping async results in REPL (use awaitResult: true) (p/let [files (vscode/workspace.findFiles **/*.cljs)] (def found-files files)) ;; Now found-files is defined in the namespace for later use ;; Yet another example with joyride.core/slurp (use awaitResult: true) (p/let [content (joyride.core/slurp some/file/in/the/workspace.csv)] (def content content) ; if you want to use/inspect content later in the session ; Do something with the content )注意其中先求值再def固化结果的模式把异步结果解包后存入命名空间中的 def便于在当前会话后续引用与检查。安全访问其他扩展的 API自动化常常需要读取其他扩展的能力。指令给出了先检查、再使用的防御性模式;; How to access other extensions safely (when-let [ext (vscode/extensions.getExtension ms-python.python)] (when (.-isActive ext) (let [python-api (.-exports ext)] ;; Use Python extension API safely (- python-api .-environments .-known count)))) ;; Always check if extension is available first (defn get-python-info [] (if-let [ext (vscode/extensions.getExtension ms-python.python)] (if (.-isActive ext) {:available true :env-count (- ext .-exports .-environments .-known count)} {:available false :reason Extension not active}) {:available false :reason Extension not installed}))要点getExtension可能返回 nil未安装扩展对象上要用.-isActive检查是否已激活导出 API 通过.-exports访问——例如上述 Python 示例最终返回一个扁平、自描述的 map{:available ... :reason ...}正是指令推崇的数据导向风格。Joyride Flares创建 WebView 与侧边栏视图Flares 是 Joyride 提供的一种便捷方式用于创建 WebView 面板与侧边栏视图并支持通过 REPL 与之交互。基本用法(require [joyride.flare :as flare]) ;; Create a flare with Hiccup (flare/flare! {:html [:h1 Hello World!] :title My Flare :key example}) ;; Create sidebar flare (slots 1-5 available) (flare/flare! {:html [:div [:h2 Sidebar] [:p Content]] :key :sidebar-1}) ;; Load from file (HTML or EDN with Hiccup) (flare/flare! {:file assets/my-view.html :key my-view}) ;; Display external URL (flare/flare! {:url https://example.com :title External Site})注意flare!返回 promise调用时应使用awaitResult: true。关键点Hiccup 样式:style属性使用 map如{:color :red :margin 10px}文件路径支持绝对路径、相对路径要求处于工作区内或 Uri 对象生命周期管理(flare/close! key)、(flare/ls)、(flare/close-all!)双向消息通过:message-handler与post-message!实现 WebView 与 REPL 之间的双向通信。指令同时提醒当演示创建状态栏按钮这类可驻留 UI 的一次性对象时务必持有该对象的引用以便后续修改与 dispose释放。常用用户模式脚本执行守卫Script Execution Guard这是最基础的守护模式——保证代码只在作为脚本被调用时执行而在 REPL 中加载时不误触发;; Essential pattern - only run when invoked as script, not when loaded in REPL (when ( (joyride/invoked-script) joyride/*file*) (main))原理即前文 API 表中的invoked-script被调用的脚本REPL 中为 nil与*file*当前文件路径二者比对。管理 Disposables统一注册到扩展上下文事件订阅等返回的 disposable 必须纳入扩展上下文的 subscriptions随扩展生命周期统一释放;; Always register disposables with extension context (let [disposable (vscode/workspace.onDidOpenTextDocument handler)] (.push (.-subscriptions (joyride/extension-context)) disposable))可视化展示结果与文件编辑指令要求 Copilot 在演示能力时以可视化方式呈现结果例如统计或汇总后用信息消息showInformationMessage展示结果生成 Markdown 文件并以预览模式打开更进阶的做法创建并打开一个 WebViewFlare通过 Joyride REPL 与之交互。文件编辑则遵循同样的原则优先用 REPL 开发确需编辑文件时优先使用结构化编辑工具structural editing tools而非直接改字面文本。从源码视角印证Joyride 在仓库 Skill 中的实际形态本仓库虽不包含 Joyride 扩展本体源码但其 skills/first-ask/SKILL.md 与 skills/boost-prompt/SKILL.md 是 Joyride 工具在实际 Skill 中集成的可运行证据first-askSkill 声明Requires the Joyride extension其工作流完全由joyride_request_human_input工具驱动——在refining阶段反复向人类开发者询问范围、交付物、约束确认无更多输入后再展示计划、建立 todo list 并开工boost-promptSkill 同样在需要澄清细节时调用joyride_request_human_input。从源码结构看可以推断这类joyride_*工具正是 Joyride 向 Copilot/Agent 暴露REPL 求值 请求人工输入能力的两面前者把 ClojureScript 表达式的求值结果交回对话流对应本文的 evaluation/awaitResult机制后者把对话暂停权交给用户。这也解释了为何指令反复强调命名空间定位与异步结果处理——它们是工具正确工作的前提。使用限制与适用前提本文所有 API 均以 Joyride 在 VS Code Extension Host 中运行 SCI ClojureScript 为前提需已安装 Joyride 扩展joyride_request_human_input等工具仅在对应扩展就绪时可用first-askSkill 明确标注了这一依赖load-file、slurp等均为异步实现并返回 promise需配合 promesa 与awaitResult: true使用不能按 Clojure 同步语义调用命名空间参数必须显式指定否则函数会落入错误命名空间涉及外部扩展如ms-python.python的访问必须先检查安装与激活状态示例中展示的是防御式访问而非假设 API 一定存在。小结这份指令把 GitHub Copilot 塑造成以 REPL 为超级武器的 Joyride 专家从命名空间加载、VS Code API 互操作、Joyride Core API到awaitResult与 promesa 的异步编排、扩展 API 的安全访问、Flares WebView 创建以及脚本执行守卫与 disposable 管理两大高频模式构成了一条逐步求值、就地验证、最后落地的完整开发闭环。配合仓库中的 joyride-workspace-automation.instructions.md面向.joyride/工作区自动化与依赖 Joyride 工具的 first-ask、boost-prompt 两个 Skill你可以把同一套 REPL 驱动方法论从个人用户脚本扩展到团队共享的项目级自动化。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考