Agent Skill / 需要 goals-iterm-mcp / MIT 开源

把任务交出去，
把进展跟到底。

为协调代理提供可重复的工作流程：指挥 iTerm2 中的 Coding CLI，查看进度、处理常规决策、恢复已停止的任务，并验证结果。

安装配置 ↓阅读文档 ↗

工作流程 / 示意

任务 → Claude Code / iTerm2
定位问题。修复。执行相关测试。

观察 → 决策 → 续跑
发送指令前，先确认执行状态。

验收 → 记录 → 收尾
改动、验收证据与审计记录。

你的任务协调代理 + Skill 通过 MCP 访问 iTerm2 Coding CLI

围绕你的终端开展工作。

带着验收标准委托任务

创建独立会话，或先确认准确的会话 ID，再接管已有工作。

先观察进度，再介入

每次下发指令后检查状态，避免重复委托；确认任务已经停止后再恢复。

留下可以复核的记录

持续维护 Markdown 审计台账，记录指令、反馈、决策、投递结果和验收证据。

安装与连接

先连接，再协调。

先安装终端连接，再安装 Skill。MCP 提供工具，Skill 提供如何使用这些工具推进任务的流程。

查看完整文档 ↗

连接 goals-iterm-mcp
在 Mac 上启用 iTerm2 Python API，将本地 MCP 服务器配置到协调代理的客户端。检查工具发现并调用 list_sessions。
MCP 安装指南
准备执行任务的 CLI
在 iTerm2 中安装并登录 Claude Code、Codex CLI 或其他目标 CLI，确认新标签页中也能正常启动。
安装完整 Skill 目录
按目标客户端支持的 Skill 机制安装，保留 goals-iterm-skill 目录下的 SKILL.md、references/ 和 agents/，再按客户端要求重新加载。
完整安装说明
明确任务与验收标准
指定项目路径和执行 CLI，写出可观察的完成标准，并要求代理使用 goals-iterm-skill。可以从下面的示例开始。

持续监控需要宿主的调度或唤醒机制，或在活跃的代理运行期间轮询。Skill 不自带后台服务；没有唤醒机制时，代理运行结束后无法继续监控。

任务示例

把委托要求说清楚。

使用 goals-iterm-skill，让 iTerm 中的 Claude Code 修复 /path/to/project 的登录问题。
先诊断，再修复，只运行相关测试。每次下发指令后监控进度，并处理常规技术决策。
仅在任务已经停止且不会自行恢复时，处理网络失败并续跑。
持续记录 Markdown 审计台账。通过验收后停止监控，汇总改动、测试和剩余问题。
不要发布。

开始之前。

安装 Skill 会自动安装 MCP 吗？

不会。需要单独在协调客户端连接 goals-iterm-mcp。仅安装 Skill 不会获得终端工具。

可以接管正在执行的 CLI 会话吗？

可以。先确认准确的会话 ID 和当前执行状态，再接管监控，避免重复下发仍在执行的任务。

审计台账会记录什么？

包括指令、CLI 反馈、决策及依据、投递结果、恢复、验收证据和收尾操作，附时间戳及关联事件 ID。它是操作记录，不是完整终端录像。

必须使用 Goal 功能吗？

不必须。宿主支持 Goal 时可以用来跟踪多步目标；不支持时也可以使用此流程。Goal 不替代监控，也不会自行提供后台唤醒。

把任务交出去，把进展跟到底。