Fengsh0923/ShriMP
GitHub: Fengsh0923/ShriMP
一个轻量级的 Claude Code 钩子框架，通过 YAML 配置为 AI 代理工作流提供写入作用域限制、输出质量审查和记忆文件管理能力。
Stars: 0 | Forks: 0
# ShriMP
**Sh**ell-based **r**untime **i**nstrumentation for **M**ulti-agent **P**olicy
一个轻量级、可配置的 [Claude Code](https://claude.ai/code) 钩子框架，为您的 AI 代理工作流添加作用域强制、质量审查和记忆管理功能。
## 它能做什么
| 组件 | 钩子 | 用途 |
|-----------|------|---------|
| `scope_guard.py` | PreToolUse | 当 Claude 在配置的路径之外进行写入时，进行阻止或发出警告 |
| `reviewer.py` | PostToolUse | 根据质量规则评估工具调用的输出，并记录发现的结果 |
| `md_memory_manager.py` | CLI 工具 | 管理 `.md` 记忆文件：重要性评分、命中追踪、自动归档 |
所有行为均由 YAML 配置驱动——没有硬编码的路径或代理名称。
## 安装
```
git clone https://github.com//ShriMP
cd ShriMP
./install.sh
```
然后将这些钩子添加到您的 `~/.claude/settings.json` 中：
```
"PreToolUse": [
{
"matcher": "Write|Edit|Bash",
"hooks": [
{ "type": "command", "command": "~/.claude/hooks/scope_guard.py" }
]
}
],
"PostToolUse": [
{
"matcher": "",
"hooks": [
{ "type": "command", "command": "~/.claude/hooks/reviewer.py" }
]
}
]
```
## 配置
安装完成后，请编辑 `~/.claude/config/` 目录下的 YAML 文件：
### `scope_guard.yaml` — 定义写入作用域
```
enabled: true
mode: warn # "warn" to start, switch to "block" once stable
write_scope:
- ~/.claude/
- ~/projects/
- /tmp/
```
项目级别的覆盖配置：在任何项目根目录下放置一个 `.scope_guard.yaml` 文件即可。
### `reviewer.yaml` — 质量规则
```
rules:
- name: tiny_write
tool: Write
check: size_kb
op: lt
value: 0.5
severity: warn
message: "File suspiciously small ({size_kb:.2f}KB)"
```
支持的操作：`lt`, `gt`, `eq`, `neq`, `is_true`, `is_false`, `contains`
### `memory_manager.yaml` — 重要性 + 归档规则
```
importance_rules:
- patterns: [hot_memory.md, goals.md]
importance: 5
- patterns: [project_*.md]
importance: 3
archive_rules:
- max_importance: 1
min_age_days: 90
```
## Memory Manager CLI
```
# 显示所有具有 importance / hit_count / age 的 memory 文件
python3 ~/.claude/scripts/md_memory_manager.py scan
# 应用 importance 规则，确保 hit_count 字段存在
python3 ~/.claude/scripts/md_memory_manager.py update
# Dry-run 归档检查
python3 ~/.claude/scripts/md_memory_manager.py archive
# 实际归档
python3 ~/.claude/scripts/md_memory_manager.py archive --run
# 增加 hit_count (由 hooks 自动调用)
python3 ~/.claude/scripts/md_memory_manager.py track hot_memory.md
```
## 日志
| 路径 | 内容 |
|------|---------|
| `~/.claude/logs/scope_guard.jsonl` | 作用域违规（已阻止或已警告） |
| `~/.claude/reviews/YYYYMMDD.jsonl` | 每日的审查员发现记录 |
## 环境要求
- Python 3.8+
- `pyyaml`（`pip install pyyaml`）— 嵌套配置必需；扁平配置无需此项即可使用
## 许可证
MIT
标签：AI 安全, AI 治理, Claude Code, CLI, Cutter, DNS解析, Hook 框架, Lerna, LLM 工具, LLM 辅助开发, PyRIT, Python, Shell 脚本, WiFi技术, YAML 配置, 代码审查, 作用域限制, 多智能体策略, 多智能体系统, 大模型开发工具, 工作流自动化, 开源项目, 无后门, 策略执行, 范围防护, 记忆管理, 质量评估, 运行时插桩, 运行时监控, 逆向工具