Qoder脚本需置于Skill目录的scripts/子目录下，通过SKILL.md中{{ run_script "xxx" }}调用，支持Python/Shell，须具可执行权限、合法JSON输出，并经Quest触发执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Qoder中通过脚本实现重复任务自动化，但尚未接触过其脚本机制，则可能是由于缺乏对scripts/目录结构、执行上下文及调用方式的基本认知。以下是掌握Qoder脚本能力的具体路径：
一、理解Qoder脚本的定位与作用
Qoder中的脚本不是独立运行的外部程序，而是Skill文件夹内scripts/子目录下的可执行模块，用于在AI执行任务（如Quest Mode）过程中触发特定逻辑，例如数据预处理、格式校验或环境检测。它必须被SKILL.md显式声明并调用，否则不会自动生效。
1、确认当前项目或用户级Skill目录中已存在scripts/子文件夹。
2、在scripts/目录下新建Python或Shell脚本文件，命名需符合小写字母+下划线规范，例如validate_input.py。
3、确保脚本文件具有可执行权限（Linux/macOS需chmod +x；Windows依赖Python解释器注册）。
4、在SKILL.md中使用MCP语法声明该脚本，例如：`{{ run_script "validate_input.py" }}`。
二、编写第一个Python脚本
Python脚本是Qoder最常用且兼容性最强的脚本类型，支持访问Qoder注入的上下文变量（如input、project_path），便于实现项目感知型自动化。
1、在Skill目录的scripts/下创建validate_input.py文件。
2、写入基础结构：第一行添加#!/usr/bin/env python3，第二行导入sys模块。
3、读取标准输入：使用import json; data = json.load(sys.stdin)接收Qoder传入的JSON上下文。
4、添加业务逻辑，例如检查data中是否存在required_field字段，并输出{"valid": true}或{"error": "missing field"}。
5、确保脚本末尾以print(json.dumps(result))向stdout返回结构化结果，Qoder将解析该输出继续后续流程。
三、编写第一个Shell脚本
Shell脚本适用于快速调用系统命令、检查工具链就绪状态或执行轻量构建动作，其执行依赖于宿主系统的shell环境，不经过Python解释器层。
1、在scripts/目录下新建check_git.sh文件。
2、首行写入#!/bin/bash，确保换行符为LF（Unix格式）。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
3、添加if command -v git > /dev/null; then echo '{"installed":true}'; else echo '{"installed":false}'; fi。
4、保存后执行chmod +x check_git.sh赋予执行权限。
5、在SKILL.md中调用时，Qoder会将其stdin设为空，stdout输出必须为合法JSON，否则触发错误中断。
四、调试脚本执行过程
脚本在Qoder中无法直接双击运行，必须通过Skill上下文触发；调试失败常因路径错误、权限缺失或JSON格式非法导致，需逐层验证执行链路。
1、在Qoder IDE中打开全局聊天面板，输入“测试validate_input.py脚本”，触发含该脚本调用的Quest。
2、观察终端面板是否显示“Running script: validate_input.py”提示。
3、若报错“Script not found”，检查scripts/是否位于正确Skill路径下，且文件名拼写完全一致（区分大小写）。
4、若报错“Permission denied”，在终端进入scripts/目录，执行ls -l确认执行位已启用（出现x字符）。
5、若报错“Invalid JSON output”，复制脚本stdout原始输出，粘贴至JSON校验网站验证格式合法性。
五、复用已有脚本模板
Qoder官方提供一组通用脚本模板，涵盖环境检测、代码风格扫描、依赖分析等高频场景，可直接下载集成，避免从零编写。
1、访问https://github.com/qoder-templates/scripts仓库，下载zip包解压。
2、将其中的python/或shell/子目录整体复制到目标Skill的scripts/目录中。
3、打开对应SKILL.md，查找{{ run_script ... }}占位符，替换为实际脚本名（如pylint_scan.py）。
4、确认模板脚本中未硬编码绝对路径，所有路径均使用$QODER_PROJECT_PATH或{{ project_path }}变量引用。
5、在Qoder中发起新Quest，选择该Skill并传入测试输入，验证脚本是否按预期输出结构化结果。
