⚡

代码本地运行验证Skill code-must-run

该技能用于强制约束代码类交付物的质量:凡是需要编写 Python、R、JavaScript、TypeScript 代码的任务(脚本、函数、程序、数据分析代码、自动化小工具、算法实现、数据处理与可视化代码,以及任何 .py/.R/.js/.ts 形式的交付物),都必须先在本机真实运行验证通过后才允许交付,严禁“只写不跑”。技能明确规定了本机各语言解释器的绝对路径与调用方式:Python 使用 ArcGIS Pro 的 arcgispro-py3(gispro)环境,R 使用本地 Rscript 4.6.1,JS/TS 使用用户 D 盘安装的 Node,Git 使用用户安装的 git.exe,并禁止使用在线执行器、第三方沙箱、内置旧版 Node 或系统 PATH 中不可用的 WindowsApps python。同时给出完整的标准工作流(识别—加载—编写—运行—修正—交付)和依赖安装策略,确保交付时附带真实运行证据。关键词:代码本地运行、运行验证、代码交付规范、禁止只写不跑、Python脚本、arcgispro-py3、gispro环境、Rscript、R语言、Node.js、JavaScript、TypeScript、npm、Git、本机解释器路径、绝对路径调用、PowerShell执行、依赖安装、conda/pip、install.packages、stdout/stderr、退出码、真实报错修正、自动化脚本、数据分析代码、代码质量保证、开发流程规范。

测试 0 次安装 6 次浏览 更新于 11/22/2026
名称 code-must-run
描述 本技能规定——凡是需要编写代码的任务(包括 Python、R、JavaScript、TypeScript 的脚本、函数、程序、数据分析代码、自动化小工具、算法实现、数据处理/可视化代码,以及任何以 .py/.R/.js/.ts 形式交付的代码),都必须在给出/交付前由 WorkBuddy 使用本机环境实际运行验证通过,禁止只写代码不运行就直接交付。凡是任务中出现“写一段代码/写个脚本/用Python/用R/用Node/帮我实现/生成代码”等诉求,或交付物包含代码文件,都必须在任务开始前第一时间加载并遵循本技能。所有代码一律使用用户自己安装的本地工具运行:Python 用 gispro 环境,R 用本地 Rscript,JS/TS 用用户 D 盘的 Node,禁止使用 WorkBuddy 内置的 Node 或在线执行器。触发词包括:写代码、写脚本、Python、R语言、Rscript、Node、npm、JavaScript、TypeScript、代码实现、数据分析代码、自动化脚本。 agent_created: true

代码必须本地跑通才能交付

铁律(不可违反)

  1. 任何代码(Python / R / JavaScript / TypeScript),在交付给用户之前,必须由 WorkBuddy 在本机实际运行验证通过。 严禁“只写不跑”就把代码当作成果交付。
  2. 必须使用用户自己安装的本地工具运行,不得用在线执行器、第三方沙箱、模拟结果或凭推理声称“应该能跑”。运行结果必须真实来自本机进程。
  3. Python 一律使用 ArcGIS Pro 的 Python 解释器(即 gispro/arcgispro-py3 环境),不使用系统 PATH 中那个不可用的 WindowsApps python,也不创建 venv 或使用其他 Python。
  4. R 一律使用本机已安装的 Rscript,不使用在线 R 服务。
  5. JS/TS 一律使用用户 D 盘安装的 Node(D:\Program Files odejs ode.exe),禁止使用 WorkBuddy 内置的 Node(C:\Users\HG\.workbuddy\binaries ode\...,版本较旧)。注意:当前会话 PATH 中内置 Node 优先级更高,直接敲 node/npm 会命中内置版本,必须用绝对路径调用用户的版本。npm/npx 同理用 D:\Program Files odejs pm.cmd 和 npx.cmd。
  6. Git 一律使用用户安装的 Git(C:\Program Files\Git\cmd\git.exe,2.56.0.4),不要假设 git 已在当前会话 PATH 中。
  7. 运行报错时,先根据真实报错修改代码,再次运行,直到通过为止;不得把带错误的代码交付,也不得用 try/except 吞掉错误假装成功。
  8. 交付时应简要说明:用了哪个解释器、运行是否成功、关键输出或验证结果。

本机解释器路径(已验证可用)

Python(ArcGIS Pro / gispro 环境)

  • 解释器:D:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe
  • 版本:Python 3.11.10,内置 arcpy 3.4,许可 ArcInfo
  • 若代码涉及地理空间处理,同时遵守 arcpy-gis-only skill(只用 arcpy)

执行形式(PowerShell):

$py = "D:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe"
& $py "路径\脚本.py"

R

  • Rscript:D:\Program Files\R\R-4.6.1\bin\Rscript.exe
  • 版本:R 4.6.1 (2026-06-24 ucrt),R_HOME = D:/Program Files/R/R-4.6.1
  • 启动时可能出现 Setting LC_* = C.UTF-8 failed 警告,属正常现象,不影响运行,可忽略。

执行形式(PowerShell):

$rscript = "D:\Program Files\R\R-4.6.1\bin\Rscript.exe"
& $rscript "路径\脚本.R"

Node / npm / npx(用户 D 盘安装,优先于内置版本)

  • node.exe:D:\Program Files odejs ode.exe(v26.13.1)
  • npm.cmd:D:\Program Files odejs pm.cmd(11.20.0)
  • npx.cmd:D:\Program Files odejs px.cmd
  • 已加入用户级 PATH,但当前 WorkBuddy 会话 PATH 中内置 Node(v22)优先级更高,故必须用绝对路径调用。

执行形式(PowerShell):

$node = "D:\Program Files
odejs
ode.exe"
& $node "路径\脚本.js"
& "D:\Program Files
odejs
pm.cmd" install

Git(用户安装)

  • git.exe:C:\Program Files\Git\cmd\git.exe(2.56.0.4)
  • 已加入用户级 PATH;同样用绝对路径调用以确保命中。

工作流

  1. 识别:任务是否需要编写 Python / R / JS / TS 代码。
  2. 加载:确认本 skill 已加载;若代码涉及地理空间内容,同时加载 arcpy-gis-only。
  3. 编写:把代码写入工作目录的脚本文件(不要在命令行里用大量内联代码,避免转义问题)。
  4. 运行:用上面对应的解释器执行脚本,捕获真实 stdout / stderr / 退出码。
  5. 修正:若有错误,依据真实报错修改并重跑,直至成功。
  6. 交付:附上成功运行的证据(关键输出/结果),并提供脚本文件路径。

依赖安装

若脚本缺少第三方包,优先在 gispro 环境中用其自带的 conda/pip 安装,或改用环境内已可用的库;R 包用 Rscript 的 install.packages() 安装。安装后仍需重新运行验证通过才能交付。若依赖确实无法在本机安装,向用户说明,不得直接交付未经运行的代码。