🤖 My-Agent-System

基于 Claude Code + DeepSeek 的自定义 AI Agent 配置方案
17 个 Skill · 20+ Plugin · Codebase Memory 知识图谱 · 全自动 Hook 调度

---

TL;DR (English)

My-Agent-System is a production-grade Agent Harness built on Claude Code with a DeepSeek backend. It upgrades a generic coding assistant into a self-orchestrating engineering team:

• 🧩 17 skills, role-based dispatch — planning → implementation → testing → review → deployment, with an auto-dispatcher that routes every task to the right agent role (planner / executor / tester / manager)
• ⚙️ Hook automation — SessionStart + PreToolUse hooks that bootstrap context and enforce knowledge-graph-first workflows
• 🧠 Cross-session memory — 4 memory types (user / feedback / project / reference) persisted across sessions
• 🗺️ Codebase memory knowledge graph — MCP-based indexing of structure, call paths and data flow; hooks intercept raw grep and steer the agent to graph queries
• 🔐 Layered permissions — 170+ pre-authorized rules for fine-grained agent control
• 💸 DeepSeek-native — runs on the DeepSeek API as a drop-in Anthropic-compatible backend at a fraction of the cost

Chinese docs follow below. MIT licensed.

---

📖 目录

• 这是什么？
• 核心亮点
• 快速开始
• 系统架构
• Skill 清单
• Plugin 清单
• Hook 机制
• Codebase Memory
• 文件结构
• 配置说明
• FAQ
• 最佳实践
• License

---

这是什么？

这是一个 Claude Code 的完整配置方案，相当于你的 AI 编程助手的「操作系统」。它包含：

• Skill 集合 — 17 个定制化技能，覆盖开发全流程（计划 → 实现 → 测试 → 审查 → 部署）
• Plugin 生态 — 20+ 官方市场插件，扩展 LSP、代码审查、提交管理等能力
• Hook 自动化 — SessionStart / PreToolUse 两层钩子，自动引导 Agent 使用知识图谱
• Codebase Memory — 基于 MCP 的代码知识图谱，索引你的项目结构、调用链、数据流
• Memory 系统 — 持久化记忆（用户偏好、项目背景、反馈记录），跨会话生效

一句话总结：把你的 Claude Code 从「聊天机器人」升级为「工程团队」。

---

核心亮点

特性	说明
角色驱动调度	auto-dispatcher 自动分析意图，路由到 计划者/执行者/测试者/管理者
链式工作流	支持自动检测 "设计→实现→测试→审查→合并" 全流程
知识图谱优先	Hook 拦截裸 grep，引导 Agent 调用 search_graph / trace_path
DeepSeek 后端	使用 DeepSeek API 替代 Anthropic 直连，降低成本
分层权限	170+ 条预授权规则，精细控制 Agent 的操作范围
跨会话记忆	user / feedback / project / reference 四种记忆类型

---

快速开始

前置条件

• Claude Code 已安装
• DeepSeek API Key（获取地址）
• Git Bash（Windows 下运行 hook 脚本）

1. 克隆本仓库

git clone https://github.com/<your-username>/My-Agent-System.git
cd My-Agent-System

2. 配置 settings.json

编辑 settings.sanitized.json，将占位符替换为你的实际值：

占位符	替换为
<YOUR_DEEPSEEK_API_KEY>	你的 DeepSeek API Key
<USERNAME>	你的 Windows 用户名

然后复制到 Claude Code 配置目录：

cp settings.sanitized.json ~/.claude/settings.json

3. 配置 CLAUDE.md

cp CLAUDE.md ~/.claude/CLAUDE.md

4. 安装 Hook 脚本

mkdir -p ~/.claude/hooks
cp hooks/* ~/.claude/hooks/
chmod +x ~/.claude/hooks/*

5. 配置 Memory 系统

mkdir -p ~/.claude/projects
cp -r memory/ ~/.claude/projects/

6. 重启 Claude Code

在 VS Code 中重新打开 Claude Code 面板，SessionStart hook 会自动加载配置。

---

系统架构

┌──────────────────────────────────────────────────────────┐
│                    VS Code Extension                       │
├──────────────────────────────────────────────────────────┤
│                      Claude Code CLI                       │
│  ┌─────────────┐  ┌──────────────┐  ┌─────────────────┐  │
│  │  settings.json │  │  CLAUDE.md   │  │  Memory (持久)  │  │
│  │  模型/hooks/权限│  │  全局行为指令  │  │  用户偏好/反馈   │  │
│  └─────────────┘  └──────────────┘  └─────────────────┘  │
├──────────────────────────────────────────────────────────┤
│                      Hook Layer                            │
│  ┌─────────────────────┐  ┌────────────────────────────┐  │
│  │  cbm-session-reminder │  │  cbm-code-discovery-gate   │  │
│  │  (启动时注入协议)      │  │  (拦截裸grep,引导图谱)      │  │
│  └─────────────────────┘  └────────────────────────────┘  │
├──────────────────────────────────────────────────────────┤
│                     Skill & Plugin                         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
│  │ 17 Skills │ │ 20+ Plugins│ │ MCP Tools │ │ Agent Tools  │ │
│  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │
├──────────────────────────────────────────────────────────┤
│                     API Backend                            │
│            DeepSeek (api.deepseek.com/anthropic)           │
│            Model: deepseek-v4-pro / DeepSeek-V3.2          │
└──────────────────────────────────────────────────────────┘

角色分工

计划者 (Planner)          执行者 (Executor)        测试者 (Tester)
writing-plans      →    executing-plans     →   test-driven-dev
taste-skill              writing-skills          systematic-debugging
                         agent-browser           requesting-code-review
                         anime-avatar-gen        receiving-code-review
                         claude-api              verify / review
                         run                     security-review
                                                 cybersecurity
                              ↓
                    管理者 (Manager)
                    auto-dispatcher
                    finishing-a-development-branch
                    codebase-memory / init / simplify
                    update-config / loop / uumit-agent

---

Skill 清单

🗂️ 管理者 (Manager) — 12 个

Skill	触发场景
auto-dispatcher	自动分析意图，路由到正确的 Skill
finishing-a-development-branch	开发完成 → 合并/PR/清理分支
using-git-worktrees	创建 Git Worktree 隔离工作区
using-superpowers	查看所有可用 Skill 及使用指南
codebase-memory	代码知识图谱的索引/查询/调用链分析
init	为新项目创建 CLAUDE.md
simplify	审查代码变更的复用性/质量/效率
update-config	管理 settings.json / 权限 / 环境变量
loop	按间隔循环执行任务
fewer-permission-prompts	分析历史调用，减少权限弹窗
keybindings-help	自定义键盘快捷键
uumit-agent	万能服务平台（兜底 Skill）

📋 计划者 (Planner) — 2 个

Skill	触发场景
writing-plans	编写设计与实现计划，定义架构和步骤
taste-skill	前端落地页 / 作品集 / UI 改版设计

⚙️ 执行者 (Executor) — 6 个

Skill	触发场景
executing-plans	按计划实现代码（inline / subagent / parallel）
writing-skills	创建 / 编辑新的 Skill 定义
agent-browser	浏览器自动化（表单填写、截图、爬取、测试）
anime-avatar-gen	通过 ComfyUI 生成动漫头像
claude-api	Claude API / Anthropic SDK 应用开发，含 prompt caching
run	启动项目应用，观察变更是否生效

🧪 测试者 (Tester) — 8 个

Skill	触发场景
test-driven-development	TDD 流程：先写测试再写代码
systematic-debugging	定位 bug 根因，验证修复有效性
requesting-code-review	发起代码审查
receiving-code-review	处理审查意见，确保修复到位
verify	启动应用观察行为，手动确认变更
review	审查 Pull Request 的代码质量
security-review	对代码进行安全审查
cybersecurity	754 个安全技能，覆盖 26 个安全领域

---

Plugin 清单

来源：claude-plugins-official 市场

开发增强

code-review · code-simplifier · feature-dev · commit-commands · code-modernization

前端与设计

frontend-design

配置管理

hookify · claude-md-management · agent-sdk-dev · mcp-server-dev

输出风格

learning-output-style · explanatory-output-style

LSP 支持

clangd-lsp · gopls-lsp · jdtls-lsp · kotlin-lsp · lua-lsp · csharp-lsp

其他

math-olympiad · cwc-makers · ralph-loop · playground

---

Hook 机制

系统通过两层 hook 确保 Agent 优先使用知识图谱而非裸文本搜索：

Layer 1: SessionStart — 协议注入

脚本: hooks/cbm-session-reminder

每次会话启动（startup / resume / clear / compact）时，向 context 注入 Code Discovery Protocol：

1. 始终优先使用 search_graph / trace_path / get_code_snippet
2. 仅在文本内容、配置值、非代码文件时回退到 Grep/Glob/Read
3. 未索引的项目先运行 index_repository

Layer 2: PreToolUse — 门控拦截

脚本: hooks/cbm-code-discovery-gate

每会话首次调用 Grep/Glob/Read/Search 时阻止执行，引导使用 MCP 工具。后续调用自动放行。

为什么这样设计？ —— LLM 习惯直接 grep 代码，但知识图谱能提供结构化调用链和数据流分析，grep 无法做到。Hook 机制强制 Agent 养成「先查图谱」的习惯。

---

Codebase Memory

使用 codebase-memory-mcp 构建代码知识图谱。

索引状态（示例）

项目	节点数	边数
manju-pipeline	183	286
Pixelle-Video	2,835	4,323

主要工具

MCP Tool	用途
search_graph	全文搜索函数/类/路由/变量（BM25 + 语义）
trace_path	追踪调用链 / 数据流 / 跨服务调用
get_code_snippet	读取函数/类源码
query_graph	执行 Cypher 图查询
get_architecture	项目结构一览
index_repository	索引新仓库到知识图谱
detect_changes	检测代码变更及影响

---

文件结构

My-Agent-System/
├── README.md                       ← 本文件
├── CLAUDE.md                       ← 全局行为指令（复制到 ~/.claude/）
├── settings.sanitized.json         ← 脱敏配置模板（复制到 ~/.claude/settings.json）
├── .gitignore
├── hooks/
│   ├── cbm-code-discovery-gate     ← PreToolUse 门控脚本
│   └── cbm-session-reminder        ← SessionStart 提醒脚本
└── memory/
    └── MEMORY.md                   ← 记忆索引模板（复制到 ~/.claude/projects/）

部署后的完整目录结构

~/.claude/
├── settings.json              ← 主配置（模型/hooks/权限）
├── CLAUDE.md                  ← 全局指令
├── credentials.json           ← API Key（建议使用此文件，不要写入 settings.json）
├── hooks/
│   ├── cbm-code-discovery-gate
│   └── cbm-session-reminder
├── skills/                    ← 17 个自定义 Skill
│   ├── agent-browser/
│   ├── anime-avatar-gen/
│   ├── auto-dispatcher/
│   ├── codebase-memory/
│   ├── cybersecurity/
│   ├── executing-plans/
│   ├── finishing-a-development-branch/
│   ├── receiving-code-review/
│   ├── requesting-code-review/
│   ├── systematic-debugging/
│   ├── taste-skill/
│   ├── test-driven-development/
│   ├── using-git-worktrees/
│   ├── using-superpowers/
│   ├── uumit-agent/
│   ├── writing-plans/
│   └── writing-skills/
├── plugins/
│   └── marketplaces/
│       └── claude-plugins-official/
└── projects/
    └── <项目名>/
        └── memory/             ← 持久记忆（user/feedback/project/reference）

---

配置说明

settings.json 核心字段

字段	说明	示例值
env.ANTHROPIC_BASE_URL	API 后端地址	https://api.deepseek.com/anthropic
env.ANTHROPIC_AUTH_TOKEN	API Key	<YOUR_KEY>
env.ANTHROPIC_MODEL	默认模型	deepseek-v4-pro
env.ANTHROPIC_DEFAULT_HAIKU_MODEL	轻量模型（/fast 模式）	DeepSeek-V3.2
env.ANTHROPIC_DEFAULT_SONNET_MODEL	标准模型	DeepSeek-V3.2
env.ANTHROPIC_DEFAULT_OPUS_MODEL	强力模型	DeepSeek-V3.2
model	CLI 默认模型	deepseek-v4-pro
effortLevel	努力级别（high/medium/low）	high
permissions.allow	预授权规则列表	见模板
permissions.additionalDirectories	允许访问的额外目录	见模板
hooks.PreToolUse	工具调用前钩子	门控脚本
hooks.SessionStart	会话启动钩子	提醒脚本

⚠️ 模型分层警告：当前 Haiku/Sonnet/Opus 全部映射到 DeepSeek-V3.2。如需真正分层，建议：

• DEFAULT_HAIKU_MODEL → deepseek-chat（快速、低成本）
• DEFAULT_SONNET_MODEL → DeepSeek-V3.2（标准）
• DEFAULT_OPUS_MODEL → deepseek-reasoner（深度推理）

权限规则语法

"Bash(curl -s http://127.0.0.1:8188/**)"   // 允许 ComfyUI API 调用
"Bash(git clone *)"                         // 允许任意 git clone
"Read(//d//**)"                             // 允许读取 D 盘所有文件
"WebSearch"                                 // 允许网络搜索
"mcp__codebase-memory-mcp__search_graph"    // 允许特定 MCP 工具

---

FAQ

Q: 为什么要用 DeepSeek 而不是 Anthropic 直连？

DeepSeek 提供兼容 Anthropic API 的端点，且在国内访问稳定、成本更低。你可以随时切换回 Anthropic 直连：将 ANTHROPIC_BASE_URL 设为 https://api.anthropic.com 并替换 token 即可。

Q: Skill 和 Plugin 有什么区别？

• Skill — 定义在 ~/.claude/skills/ 下的 Markdown 文件，通过 Skill() 工具调用，直接注入 prompt 指导 Agent 行为
• Plugin — 来自 Claude Code 插件市场，可包含 Skill / Hook / Agent / Command 等复合组件

Q: 如何添加新的 Skill？

1. 在 ~/.claude/skills/<skill-name>/SKILL.md 创建定义文件
2. 运行 Skill(skill="writing-skills") 或手动编写
3. auto-dispatcher 会自动检测并更新路由表

Q: Codebase Memory 索引需要多久？

取决于项目规模。小项目（<500 文件）约 1-2 分钟，大项目（2000+ 文件）约 5-10 分钟。

Q: 如何验证系统是否正常工作？

重启 Claude Code，观察 session start 时应看到 "CRITICAL - Code Discovery Protocol" 提示。首次用 Grep 时会被拦截并引导至 MCP 工具。

---

最佳实践

1. API Key 安全

   • 使用 ~/.claude/credentials.json 存储 token，勿直接写在 settings.json 中
   • 定期轮换 API Key
   • 确保 credentials.json 在 .gitignore 中

2. 模型分层

   • 为 Haiku / Sonnet / Opus 分配不同的模型以利用 Claude Code 的分层策略
   • /fast 模式使用 Haiku → 映射到最快的 DeepSeek 模型

3. 定期维护

   • 清理 ~/.claude/telemetry/ 中的失败事件
   • 审查 ~/.claude/projects/*/memory/ 中过时的记忆
   • 更新 auto-dispatcher 的路由表以匹配新安装的 Skill

4. 版本控制

   • 将本仓库作为配置模板维护
   • 排除 credentials.json 和 telemetry/
   • 每次更新 Skill/Plugin 后提交变更

5. 安全审查

   • 定期运行 Skill(skill="security-review") 检查代码安全
   • 使用 cybersecurity Skill 进行渗透测试

---

License

MIT

---

_{Built with ❤️ using Claude Code}