Gitagent
Git 原生 AI 智能体框架：将智能体的身份、规则、记忆、工具和技能都版本化为文件，让智能体即仓库。
证据显示有权限控制机制（如allowedTools/disallowedTools、hooks中的preToolUse可阻断/修改工具调用），但未明确默认最小权限策略；用户确认机制存在（human_in_the_loop配置、hooks可阻断），但非强制默认；数据流透明度部分：有审计日志和遥测，但未说明数据流向用户；敏感数据处理：支持环境变量插值，但未明确加密或脱敏；依赖安全：使用npm包，有供应链扫描考虑（拆分voice包），但未提供依赖漏洞扫描证据；外部影响：有sandbox选项和hooks可限制，但默认允许cli执行；回滚：git原生支持，但未明确提供回滚工具；来源归属：插件有author字段，但未验证。
自一致性：文档与代码结构一致，测试覆盖了关键安全修复（如G1、G25），但未全面测试所有功能；依赖可用性：依赖较多，但未提供锁定文件或完整性校验；失败消息：有错误处理（如fail-soft MCP），但未提供用户友好的错误提示示例。
受众与场景：面向开发者，提供CLI、SDK、插件等，场景多样；能力边界：有工具白名单/黑名单，但未明确默认边界；触发精度：有hooks和技能触发，但未详细说明触发条件；环境适配：支持多模型、多平台，但未明确操作系统兼容性。
信息架构：文档结构清晰，有架构图；安装说明：提供一键安装和手动安装，但未提供卸载说明；命名稳定性：版本2.2.0，但未提供命名规范；示例与FAQ：有大量示例，但无FAQ；已知限制：提到MCP仅支持tools，但未列出其他限制；许可证：MIT，明确；版本与变更日志：有版本号，但无CHANGELOG；维护责任：作者字段存在，但未明确维护承诺。
输出可用性：提供流式输出和结构化消息，便于集成；边际价值：git-native概念有创新，但需验证实际价值；成本效益：有成本追踪，但未提供性能基准。
声明可追溯：README中的功能大多有代码或测试支持，但部分声明（如'always learning'）未验证；跨来源佐证：仅单一来源，无外部验证；事实与推断分离：文档中未明确区分事实与推断。
- 未验证发布者身份，需谨慎使用。
- 默认允许cli执行，可能带来安全风险，建议配置hooks或sandbox。
- 依赖较多，未提供锁文件，供应链风险需关注。
- 文档中部分宣传性声明（如'always learning'）缺乏证据支持。
这个 Agent 能做什么，适合哪些场景？
Gitagent（原 Gitclaw）是一个 Git 原生的多模态 AI 智能体框架，运行在 Node.js 环境，将智能体的完整配置放在一个 Git 仓库中：agent.yaml 定义模型与工具，SOUL.md 定义人格，RULES.md 定义行为约束，memory/ 存储带完整历史的记忆，tools/ 通过 YAML 声明式定义工具，skills/ 提供可组合技能模块，hooks/ 管理生命周期钩子。智能体通过 CLI 或 SDK 运行，支持 Local Repo 模式（克隆 GitHub 仓库并在会话分支上自动提交）、插件机制（Git URL 安装）、MCP 客户端、多模型（OpenAI、Anthropic、Google 等）和 OpenTelemetry 遥测。该框架以 'agents as repos' 为核心，支持分叉、分支、git log 记忆、规则差异对比等 Git 原生工作流。
Gitagent 执行的核心操作包括：读取和解析 agent.yaml、SOUL.md、RULES.md 等配置文件以组装系统提示词；通过内置工具（cli、read、write、memory）执行 shell 命令、读写文件、加载和保存 git 提交记忆；运行声明式工具（如 tools/search.yaml 中的脚本工具）和技能模块；调用生命周期钩子（如 pre_tool_use、on_error）进行门控和审计；通过 MCP 协议连接外部服务器（如 filesystem、GitHub、Postgres）并自动注册其工具为 <server>__<tool> 格式；在 Local Repo 模式下，gitagent --repo 克隆仓库并自动提交到会话分支；通过 SDK 的 query() 函数流式返回消息（delta、assistant、tool_use、tool_result 等）。输出是智能体的响应文本、工具调用结果、审计日志和遥测数据。
- 开发者用 gitagent --dir ~/my-project "解释这个项目并提出改进" 在本地项目上运行智能体分析并建议改进。
- 团队使用 gitagent --repo https://github.com/org/repo --pat ghp_xxx "修复登录 bug" 让智能体在给定仓库的会话分支上自动修复问题，并提交修改。
- 需要复用统一人格和规则的组织，可通过 extends 字段继承基础智能体，并在子智能体中定制技能和工具。
- 安全敏感环境中，使用 hooks 在工具调用前拦截危险命令（如 rm -rf）或强制修改参数路径。
- 需要连接外部服务的开发者，在 agent.yaml 或 SDK 中配置 MCP 服务器，让智能体自动发现并使用 Postgres、GitHub 等工具。
- 想进行智能体行为追踪的工程团队，设置 OTEL_EXPORTER_OTLP_ENDPOINT 开启 OpenTelemetry 遥测，观察令牌消耗、成本及工具调用性能。
这个 Agent 有哪些优点和局限？
- Git 原生设计：智能体配置和记忆全部版本化，支持分叉、分支、git log 记忆历史和规则差异对比。
- 多模型支持：通过 pi-ai 支持 Anthropic、OpenAI、Google、xAI、Groq、Mistral 等，且可在 agent.yaml 中配置回退模型。
- 内置 MCP 客户端，可连接大量现成服务器，无需编写集成代码，减少开发成本。
- 提供 TypeScript SDK，支持流式查询、自定义工具和程序化插件 API，便于嵌入现有应用。
- 包含合规与审计功能（如风险级别、人机环路、审计日志），适合企业级部署。
- 依赖 Node.js 和 Git 环境，需要安装全局包和配置 API 密钥。
- 语音和 Web UI 为独立包 @open-gitagent/voice，需额外安装，可能被供应链扫描器拒绝。
- MCP 支持仅限工具，资源和提示词尚未暴露。
- 多模型支持依赖 pi-ai 库，可能引入外部依赖风险。
- 文档表明 2.0 版本从 1.x 迁移时语音包需手动分离安装。
如何安装或部署这个 Agent？
安装要求 Node.js 18+（推荐 20+）、npm 和 git。一键安装：执行 bash <(curl -fsSL "https://raw.githubusercontent.com/open-gitagent/gitagent/main/install.sh?$(date +%s)") ，脚本会全局安装 npm 包、引导 API 密钥设置，并在本地 3333 端口启动语音 UI。手动安装精简 CLI 和 SDK：npm install -g @open-gitagent/gitagent；如需语音和 Web UI，额外安装 npm install -g @open-gitagent/voice。在沙箱或 CI 环境可设置 GITAGENT_SLIM=1 跳过语音。
如何使用这个 Agent？
首先设置 API 密钥（如 export OPENAI_API_KEY="sk-..."），然后在代理目录下运行：gitagent --dir ~/my-project "解释这个项目"。首次运行会自动创建 agent.yaml、SOUL.md、memory/ 等脚手架。也可使用 --repo <GitHub URL> 和 --pat 或 GITHUB_TOKEN 处理远程仓库，并用 --session 恢复会话。SDK 用法：在 TypeScript 中 import { query } from "gitagent"，传入 prompt、dir、model 等选项并异步迭代流式消息。安装语音后可使用 gitagent --voice 进入语音交互模式。可编辑 agent.yaml 配置模型（如 preferred: "anthropic:claude-sonnet-4-5-20250929"）、工具、MCP 服务器和合规策略。