Agent-Harness：可移植的 Claude Code 智能体基础设施框架

核心观点：Agent-Harness是专为Claude Code设计的可移植智能体基础设施框架，旨在解决新项目中复用AI辅助工作流、提示词模板和代理配置的痛点。它通过模块化组件（钩子系统、技能库、代理配置、Sprint规划工作流）实现标准化，让任何项目快速获得AI辅助开发能力。项目由Mark Hazlett维护，开源在GitHub（链接：https://github.com/markhazlett/agent-harness），发布于2025年5月。

背景：传统Claude Code使用依赖项目内的.claude目录和本地配置，导致每个新项目需重新设置，已优化的提示词和技能难以跨项目迁移。 项目来源：由Mark Hazlett（@markhazlett）开发维护，发布于GitHub，原始标题为"agent-harness: Portable Claude Code agent infrastructure"，发布时间2025年5月。

Agent-Harness采用模块化设计，包含四大核心组件：

1. 钩子系统（Hooks）：事件响应机制，支持预提交、代码审查、构建等钩子，将AI辅助从"按需调用"转为"自动响应"。
2. 技能库（Skills）：可复用能力单元，内置代码重构、文档生成、测试生成、架构评审等技能，支持YAML定义定制。
3. 代理配置（Agents）：预设架构师、审查者、调试专家等代理角色，包含角色定义、系统提示词、工具权限等配置。
4. Sprint规划工作流：整合敏捷开发，支持待办梳理、工作量估算、任务分解、进度跟踪、回顾辅助等功能。

为实现跨项目复用，Agent-Harness采用以下设计：

• 标准化目录结构：统一布局（hooks/、skills/、agents/等），降低学习和迁移成本。
• 配置继承与覆盖：支持基础→组织→项目三层配置，下层继承上层并可按需覆盖。
• 版本化管理：配置可作为Git子模块/独立仓库管理，内置版本检查确保与Claude Code兼容性。

部署步骤：1. 运行setup.sh初始化目录；2. 编辑AGENTS.md定义需求；3. 集成钩子到Git工作流；4. 在Claude Code加载配置。 适用场景：

• 多项目开发团队：确保AI辅助体验一致性；
• 开源项目维护者：降低贡献者门槛，保证代码审查和文档质量；
• 咨询交付团队：快速建立验证过的工作流；
• 个人开发者：复用优化的AI辅助模式提升效率。

总结：Agent-Harness是AI辅助开发工具系统化的体现，帮助团队从"随意使用"Claude Code升级到"系统应用"，解决配置与知识资产管理的关键需求。 生态关系：不替代Claude Code，而是增强其能力，兼容现有功能（如/agents命令、.claude目录等）。 社区：开源模式，鼓励贡献新技能、代理配置、钩子脚本等，模块化架构支持独立扩展。