# agent-tools

**Repository Path**: nister/agent-tools

## Basic Information

- **Project Name**: agent-tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# agent-tools

两个阻止 AI 编程助手犯错的工具。解决的问题，提示词修不了。

## 问题

**问题一：Agent 会忘。** 你花了两个小时调试，上下文窗口满了，系统开始压缩，细节消失。你开新会话，Agent 什么都不记得。你从头解释。

**问题二：Agent 会编。** 它给你一个自信的答案，听起来很对，没有任何来源。你不亲自核实，根本分不清是真的还是幻觉。

这两个问题提示词都解决不了。上下文压力下模型会忽略提示词。这两个工具以代码形式运行在模型之外，确定性执行，无法绕过。

## 工具

### FlashRecall — 不让 Agent 忘

在关键节点丢一个命名锚点。工具自动捕获 git 分支、工作目录和打开的文件。锚点自动链接成链。之后唤醒记忆链注入新会话，Agent 即刻接上之前的状态。

[FlashRecall README →](flashrecall/README.md)

### ClaimGate — 不让 Agent 编

把 Agent 的输出过一遍 ClaimGate。它会拆解文本为单条断言，为每条查找来源证据，贝叶斯评分。没来源的直接拦截，弱来源的标记为推测，只有确实有证据的才放行。

[ClaimGate README →](claimgate/README.md)

## 安装

```bash
git clone https://gitee.com/nister/agent-tools.git
cd agent-tools

# FlashRecall — 纯标准库，无需 pip
ln -sf $(pwd)/flashrecall/flashrecall.py /usr/local/bin/flashrecall

# ClaimGate — 需 pyyaml
pip install pyyaml
ln -sf $(pwd)/claimgate/claimgate.py /usr/local/bin/claimgate
```

Python 3.10 以上。

## MCP

两个工具都提供 MCP Server，兼容 Claude Code、Cursor、Continue。

```json
{
  "mcpServers": {
    "flashrecall": {
      "command": "python3",
      "args": ["/path/to/agent-tools/flashrecall/mcp_server.py"]
    },
    "claimgate": {
      "command": "python3",
      "args": ["/path/to/agent-tools/claimgate/mcp_server.py"]
    }
  }
}
```

## License

MIT