AgentSkillsCN

iterate

iterate --bridge 交互指南。当调用 iterate --bridge 失败、端口不可用、服务器未启动时触发。提供自动启动服务器、端口检测、故障恢复的完整流程。触发词：iterate、cunzhi、寸止、端口不可用、KeepGoing=false、服务器未启动。

中文原作
SKILL.md
--- frontmatter
name: iterate
description: iterate --bridge 交互指南。当调用 iterate --bridge 失败、端口不可用、服务器未启动时触发。提供自动启动服务器、端口检测、故障恢复的完整流程。触发词：iterate、cunzhi、寸止、端口不可用、KeepGoing=false、服务器未启动。

iterate Skill

iterate --bridge 模式交互指南（Rust 原生，比 Python 更快）。

⚠️ 重要：使用 --bridge 模式

推荐使用 iterate --bridge 替代 Python 脚本。

bash
# ✅ 推荐：使用 --bridge 模式（Rust 原生，更快）
clear && printf '%s\n' '## 标题' '' '内容' > ~/.cunzhi/5312/output.md && /Applications/iterate.app/Contents/MacOS/iterate --bridge --port 5312 --workspace "/Users/apple/cunzhi"

优势：

  • •Rust 原生，启动更快
  • •无需 Python 依赖
  • •更少的进程开销

正常调用流程

  1. •写入任务摘要到 ~/.cunzhi/{PORT}/output.md
  2. •调用 iterate --bridge --port {PORT} --workspace "/项目路径"
  3. •等待返回 KeepGoing=true/false
  4. •读取 ~/.cunzhi/{PORT}/input.md 获取用户指令

故障自动恢复

端口不可用 (Port not available)

当脚本返回 Error: Port {PORT} is not available 时：

  1. •

    自动启动服务器（非阻塞）：

    bash
    iterate --serve --port {PORT}
  2. •

    等待 2-3 秒后重新调用脚本

  3. •

    如果仍然失败，提示用户手动检查

服务器已运行但无响应

  1. •检查进程：lsof -i :{PORT}
  2. •如有僵尸进程，提示用户 kill
  3. •重新启动服务器

VS Code 插件集成

如果 VS Code 插件未自动启动服务器：

  • •插件应在激活时自动运行 iterate --serve --port {PORT}
  • •当前需要手动启动，后续可优化插件逻辑

端口约定

环境端口
Windsurf5315
VS Code5314
Cursor5316