生成终端Skill spawn-terminal

---

name: spawn-terminal description: “生成一个新的终端窗口来运行CLI命令（ffmpeg、curl、python等）。用于非AI命令执行。”

目的

生成一个新的终端窗口来执行CLI命令。此技能用于通用命令执行，而非生成AI智能体。如需生成AI智能体，请改用 spawn:agent 技能。

变量

变量	默认值	描述
LOG_TO_FILE	false	将完整的终端输出写入调试文件
CAPTURE	false	阻塞并直接返回输出

使用说明

强制要求 - 您必须按顺序遵循以下工作流程步骤。请勿跳过任何步骤。

1. 识别用户想要运行的CLI命令
2. 首先运行 <command> --help 以验证语法和选项
3. 使用 fork_terminal() 在新终端中执行命令

危险信号 - 停止并遵循操作手册

如果您即将：

• 在不检查其 --help 的情况下执行命令
• 假设您知道命令语法
• 以“因为很简单”为由跳过 --help 步骤
• 生成AI智能体（请改用 spawn:agent）

停止 -> 先运行 <command> --help -> 查看输出 -> 然后继续

工作流程

强制检查点 - 在继续之前验证每一项：

1. [ ] 理解用户的请求
2. [ ] 验证：这是一个CLI命令，而非AI智能体请求
3. [ ] 阅读：‘…/agent/fork_terminal.py’ 以了解工具
4. [ ] 遵循操作手册：阅读 ‘./cookbook/cli-command.md’
5. [ ] 检查点：已运行 <command> --help 并查看了选项
6. [ ] 执行 fork_terminal(command, log_to_file=False, log_agent_output=False)

操作手册

CLI命令

• 如果：用户请求任何非AI的CLI命令（ffmpeg、curl、python、npm等）
• 那么：阅读并执行 ‘./cookbook/cli-command.md’
• 示例：
  • “创建一个新终端来运行 ffmpeg”
  • “生成一个带有 curl 的终端”
  • “分叉一个终端来运行 python script.py”
  • “新终端：npm run build”

使用方法

fork_terminal() 函数位于 ../agent/fork_terminal.py：

from spawn.agent.fork_terminal import fork_terminal

# 简单命令执行（不捕获输出）
fork_terminal("npm run build")

# 带有调试输出捕获
file_path = fork_terminal("ffmpeg -i video.mp4 output.gif", log_to_file=True)

# 阻塞式捕获（等待完成）
output = fork_terminal("python script.py", capture=True, log_to_file=True)

何时应改用 spawn:agent

如果用户提及以下任何内容，请使用 spawn:agent：

• Claude, Claude Code
• Codex, OpenAI
• Gemini, Google
• Cursor
• OpenCode
• Copilot, GitHub Copilot
• “AI agent”, “coding agent”, “spawn agent” （“AI智能体”、“编码智能体”、“生成智能体”）