| 名称 | 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 |
代码必须本地跑通才能交付
铁律(不可违反)
- 任何代码(Python / R / JavaScript / TypeScript),在交付给用户之前,必须由 WorkBuddy 在本机实际运行验证通过。 严禁“只写不跑”就把代码当作成果交付。
- 必须使用用户自己安装的本地工具运行,不得用在线执行器、第三方沙箱、模拟结果或凭推理声称“应该能跑”。运行结果必须真实来自本机进程。
- Python 一律使用 ArcGIS Pro 的 Python 解释器(即 gispro/arcgispro-py3 环境),不使用系统 PATH 中那个不可用的 WindowsApps
python,也不创建 venv 或使用其他 Python。 - R 一律使用本机已安装的 Rscript,不使用在线 R 服务。
- 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。 - Git 一律使用用户安装的 Git(
C:\Program Files\Git\cmd\git.exe,2.56.0.4),不要假设git已在当前会话 PATH 中。 - 运行报错时,先根据真实报错修改代码,再次运行,直到通过为止;不得把带错误的代码交付,也不得用 try/except 吞掉错误假装成功。
- 交付时应简要说明:用了哪个解释器、运行是否成功、关键输出或验证结果。
本机解释器路径(已验证可用)
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-onlyskill(只用 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;同样用绝对路径调用以确保命中。
工作流
- 识别:任务是否需要编写 Python / R / JS / TS 代码。
- 加载:确认本 skill 已加载;若代码涉及地理空间内容,同时加载
arcpy-gis-only。 - 编写:把代码写入工作目录的脚本文件(不要在命令行里用大量内联代码,避免转义问题)。
- 运行:用上面对应的解释器执行脚本,捕获真实 stdout / stderr / 退出码。
- 修正:若有错误,依据真实报错修改并重跑,直至成功。
- 交付:附上成功运行的证据(关键输出/结果),并提供脚本文件路径。
依赖安装
若脚本缺少第三方包,优先在 gispro 环境中用其自带的 conda/pip 安装,或改用环境内已可用的库;R 包用 Rscript 的 install.packages() 安装。安装后仍需重新运行验证通过才能交付。若依赖确实无法在本机安装,向用户说明,不得直接交付未经运行的代码。