agent-harness
一个用于配置和运行AI智能体的TypeScript运行时框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-harness。 它的用途是：一个用于配置和运行AI智能体的TypeScript运行时框架。 完整的 Skill 内容见：https://321skill.com/skills/agent-harness/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'agent -p "分析当前目录下所有.md文件，并生成一份内容摘要报告"'，它会调用配置好的LLM模型，并结合文件系统工具读取文件内容，最终生成分析报告。或者，在开发时，你可以说：'agent --sandbox --tools'，来在安全隔离的环境中查看当前所有可用的工具列表，以便进行调试和集成。
介绍
Agent Harness 是一个AI智能体的运行时框架，它本身不具备智能，而是为智能体提供可靠的基础设施。它解决了开发者在构建和部署AI智能体时面临的基础设施难题，如模型接入、工具执行、安全隔离和会话管理等。
使用上，你只需通过命令行安装，运行 agent config init 初始化配置，即可通过 agent 命令启动交互式聊天，或使用 agent -p "你的指令" 执行单次任务。它支持在运行时动态切换不同的LLM提供商和模型。
这个框架非常适合智能体开发者、全栈工程师以及任何希望快速构建、测试和部署AI应用，但又不想从零搭建复杂底层管道的技术实践者。
建议在使用时，先通过 agent config show 了解默认配置，并根据需要设置提供商。对于涉及敏感操作或不可信代码的场景，强烈建议使用 --sandbox 参数在沙箱中运行以确保安全。
核心特点
与许多直接提供预设行为的智能体不同，Agent Harness 明确将自己定位为“基础设施”而非“驾驶员”，专注于提供稳定、可扩展的运行环境，将行为定义（通过AGENTS.md、技能和命令）完全交给用户，实现了底层框架与上层智能的彻底解耦。
注意事项
它本身不提供预设的智能体行为或任务解决方案，需要用户自行配置和定义，因此不适合希望开箱即用、直接获得现成功能智能体的用户。
常见问题
Agent Harness 和直接调用 OpenAI API 有什么区别？
它提供了工具执行、安全沙箱、会话管理、多模型切换等一整套运行时环境，而不仅仅是API调用。
是否需要编程才能使用？
基础交互式聊天无需编程，但自定义智能体行为、工具或技能需要一定的TypeScript/JavaScript开发能力。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-harness/raw/index.md 读取 agent-harness 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-harness/raw/index.md（查看排版版本）