agent-exec
一个轻量级代理执行器，统一调用主流AI编码工具并汇总变更。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-exec。 它的用途是：一个轻量级代理执行器，统一调用主流AI编码工具并汇总变更。 完整的 Skill 内容见：https://321skill.com/skills/agent-exec/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用Claude Code，为当前项目的用户认证模块添加JWT令牌刷新逻辑。”，它会调用配置好的claude CLI执行该任务，并在完成后输出一个JSON报告，详细列出所有被修改或创建的文件及其内容，方便你审查或自动提交。你也可以在CI脚本中用它来执行代码重构指令并自动分析影响范围。
介绍
agent-exec 是一个专为AI代理设计的轻量级命令行包装器，旨在解决开发者在同时使用多个AI编码工具（如Codex、Claude Code、Cursor）时，命令不统一、变更结果难以追踪的问题。它通过一个统一的接口调用底层代理，并自动执行git status来捕获和汇总代码变更，将结果以结构化JSON格式输出，便于后续自动化流程处理。
使用方式非常直接，通过npx命令配合提示词和指定的代理名称即可运行。例如，npx agent-exec "添加API健康检查端点" --agent codex。它还支持传递额外参数给底层CLI，如指定模型或调整token数量，并可通过环境变量进行灵活配置。
这个工具非常适合那些已经在日常开发中深度集成AI编码助手，并希望将AI生成的代码变更自动化集成到CI/CD流程、版本管理或与其他智能体协作的开发者。它充当了人类指令、AI代理和下游自动化工具之间的桥梁。
需要注意的是，使用前需确保目标代理的CLI（如codex、claude、agent）已正确安装并配置在系统PATH中。其核心价值在于变更的捕获与标准化输出，本身并不执行复杂的代码逻辑分析或质量检查。
核心特点
与单一功能的AI编码插件不同，agent-exec的核心在于“标准化输出”和“多代理抽象”。它不局限于某个特定AI工具，而是为Codex、Claude Code、Cursor提供了一个统一的执行层，并强制输出包含文件内容和变更状态的标准化JSON摘要，这使其能无缝接入需要结构化变更数据的自动化流水线或多智能体协作场景。
注意事项
不适合仅需在单一IDE或单一AI工具内进行交互式编码、无需捕获和传递结构化变更结果的场景。
常见问题
agent-exec支持哪些AI编码工具？
目前主要支持Codex、Claude Code和Cursor的CLI工具。
输出的JSON摘要包含哪些信息？
包含执行状态、代理信息、工作目录、退出码以及详细的文件变更列表（路径、状态、文件内容）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-exec/raw/index.md 读取 agent-exec 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-exec/raw/index.md（查看排版版本）