主题
05-01 · 工具调用体系：四级武器库
我们把每个人的"AI 工具调用体系"分成四级。等级越高、复用度越大、组织级杠杆越强。你的目标是 3 个月内把四级全部搭起来。
四级武器库总览
| 级别 | 资产 | 颗粒度 | 触发方式 | 例子 |
|---|---|---|---|---|
| 一级 | Snippet（代码 / 命令片段） | 单步 | 人手动复制 | "导出 PostgreSQL 表结构的 SQL" |
| 二级 | Prompt 模板 | 单次对话 | 人手动粘贴 | "用 X 风格写一个 Y" |
| 三级 | Skill | 一类任务 | Agent 自动加载 | qdy-commit、qdy-pr-review |
| 四级 | MCP server | 一类能力 | Agent 自动调用 | github-mcp、obsidian-rag、firecrawl |
一级：Snippet 库（最基础）
怎么搭
放进 Obsidian Vault 的 50-Snippets/ 目录：
50-Snippets/
├── README.md ← 索引
├── docker.md ← Docker 常用命令
├── postgres.md ← PostgreSQL 命令
├── git-magic.md ← Git 高级用法
├── shell-oneliners.md ← shell 单行神技
└── pyenv.md心法
- 每条 snippet 都要有"什么时候用"
- 写一个简短背景（"我曾经因为 X 折腾了 2 小时，最终用 Y 解决"）
- 让 Claude Code 能直接读它（CLAUDE.md 里加一行：
常用片段在 ~/qdy-vault/50-Snippets/）
二级：Prompt 库
怎么搭
50-Snippets/
└── prompt-library/
├── README.md
├── code-review.md ← Code Review 标准 prompt
├── pr-summary.md ← PR 总结 prompt
├── client-research.md ← 客户调研 prompt
├── ux-critique.md ← UI 评审 prompt
└── interview-question.md ← 面试题生成 prompt模板格式（必须统一）
markdown
---
name: code-review
purpose: 对一个 PR 做严格的 Code Review
inputs:
- diff: git diff 内容
- context: 项目背景
output_format: 结构化（按问题严重度分组）
---
# Prompt
你是一位资深工程师，正在 review 一个 PR。
## 评审维度
1. 正确性
2. 可读性
3. 性能
4. 安全
5. 测试覆盖
## 输出要求
- 严重度：🔴 阻塞 / 🟡 建议 / 🟢 微调
- 每条问题给出文件路径 + 行号 + 具体建议
# 示例
...心法
- 所有"我用了不止一次的对话开头"都要抽成 Prompt 模板
- Prompt 模板久了会膨胀 → 每月精简一次
- 当一个 Prompt 已经"稳定"到每次都用相同模板，升级成 Skill
三级：Skill 库（个人 → 团队）
怎么搭
~/.claude/skills/ → 软链到 ~/qdy-vault/40-Skills/或反过来：把 Vault 里的 40-Skills/ 软链到 Claude Code skills 目录。
公司 Skills 命名约定
| 前缀 | 含义 |
|---|---|
qdy- | 公司级（团队共享） |
me- | 个人专属 |
proj-{项目名}- | 项目专属 |
例：qdy-commit、me-daily-summary、proj-leadgen-extract-icp
心法（重要）
- Snippet 用 3 次 → 升级为 Prompt
- Prompt 用 5 次 → 升级为 Skill
- Skill 在 5 个项目里用过 → 提交到公司仓库
- 公司仓库的 Skill 被 5 个人用过 → 写入 onboarding 必修
四级：MCP 武器库
怎么搭
把你常用的所有外部能力统一接成 MCP，列表写进 Obsidian：
50-Snippets/
└── mcp-arsenal.mdmarkdown
# 我的 MCP 武器库
| 名字 | 用途 | 安装命令 | 是否需要 Key |
| --- | --- | --- | --- |
| filesystem | 本地文件读写 | `claude mcp add filesystem ...` | 否 |
| github | 读 issue/PR | `claude mcp add github ...` | 是（GH_TOKEN）|
| firecrawl | 网页抓取 | `claude mcp add firecrawl ...` | 是 |
| postgres-prod | 公司主库（只读）| ... | 是 |
| obsidian-rag | 知识库检索 | ... | 否 |
| codex | 双 AI 协同 | ... | 是 |
| chrome-devtools | 浏览器调试 | ... | 否 |心法
- 任何一个能力，第二次自己写工具调用代码 = 该把它包成 MCP 了
- 公司内部已有的 MCP（IT 内网）优先用，不要重造
- 涉密的 MCP（如生产数据库）必须 read-only + 限定行数
武器库间的"互相调用"
这是高手和初学者的真正分界线：
你说："帮我做 X 公司的客户调研"
↓
Agent 加载 qdy-client-research（Skill）
↓
Skill 内部告诉 Agent：调用 firecrawl MCP 抓官网，调用 postgres MCP 查内部库
↓
Skill 引用 50-Snippets/research-template.md（Prompt 模板）格式化输出
↓
最终结果写到 Obsidian Vault（自动通过 obsidian-rag MCP 索引）
↓
下次类似任务时，Agent 通过 RAG 找到这次的报告作为参考这一条流水你必须能从头到尾走一遍。如果走不通，说明你的体系还有漏洞。
自查清单（公司用来评估未来股东 3 个月的标准）
- [ ] 我有自己的 Snippet 库（≥ 10 篇笔记）
- [ ] 我有自己的 Prompt 模板（≥ 5 个稳定模板）
- [ ] 我至少写了 3 个 Skill 并跑通过
- [ ] 我至少接了 5 个 MCP servers 并日常使用
- [ ] 我的 Skills 至少有 1 个被同事采纳
- [ ] 我能在不到 5 分钟内把一份新需求拆给 Agent
达标 = 你已经从"新进股东"成长为"独立作战的股东"。
继续 → 02 · 项目框架沉淀