73
// 项目简介
Harmonist 是一个便携式多 Agent 框架，它通过机械化的 IDE 级钩子而非依赖 LLM 提示词来强制执行开发协议。它提供了一个结构化且经过验证的内存系统以及供应链验证，以确保代码变更符合不可妥协的质量和安全标准。该框架可与 Cursor 和 Claude Code 等主流 AI 编程助手无缝集成，提供 186 个专用 Agent 目录，且无需外部运行时或数据库。
// 技术分析
Harmonist 是一个便携式 AI 智能体编排框架，它将协议执行从基于软提示（soft prompt）的请求转移到了机械化的 IDE 级门控。通过利用 shell 和 Python 钩子（hooks），它确保了关键工程工作流程（如安全审查和 QA 验证）是不可协商的，从而防止 AI 编码助手静默跳过强制性步骤。该设计优先考虑供应链完整性和结构化内存，提供了一种稳健、无依赖的解决方案，它作为磁盘上的状态机运行，而不是依赖外部运行时或数据库。
// 核心亮点
01
机械协议执行使用 IDE 钩子来阻止不符合强制性审查或 QA 要求的代码更改。
02
供应链验证利用 SHA-256 清单哈希来防止安装或执行被篡改的智能体定义。
03
结构化内存管理强制执行严格的 YAML 模式，并执行自动化的密钥扫描以防止凭据泄露。
04
包含 186 个领域特定专家的精选目录允许进行精确的、基于标签的智能体路由，而不是依赖通用的编码角色。
05
零依赖架构完全依赖 Python 标准库和 bash，确保了跨平台兼容性，且没有外部运行时开销。
06
Integration-as-a-prompt 允许 AI 助手通过读取项目特定要求并引导必要的执行钩子来进行自我配置。
// 典型使用场景
01
针对 AI 生成的代码变更，通过机械化手段强制执行强制性代码审查和 QA 门禁
02
针对 Agent 定义和项目文件进行供应链完整性验证
03
具备自动密钥模式扫描功能的结构化、模式验证内存管理
// 快速开始
首先，将存储库克隆到您的项目根目录，并在支持 AI 的 IDE（如 Cursor）中打开它。在 Agent 模式下，粘贴 'integration-prompt.md' 的内容，让 AI 自动分析您的项目、选择合适的专家并安装必要的执行钩子。或者，您可以通过在项目目录中运行 'python3 harmonist/agents/scripts/integrate.py --pack harmonist --project .' 来使用 CLI 集成脚本。