先说说为啥要给Agent装Skill

哈哈，你要是搞AI，肯定听说过Skill。

其实Skill就像Agent的外挂插件，Neng让它直接上手干活儿。

咱们不整这些，AI只Neng硬邦邦地回答，根本不懂业务细节。

你懂的，真正的生产环境里代码审查、Git提交、文档生成这些dou得靠Skill。

整体思路：发现 → 解析 → 使用 → 管理

这四步基本就是我们给Agent加Skill的全流程。

先把Skill所在目录给找出来然后读SKILL.md元信息，再把它塞进上下文，Zui后在需要时调起来。

别急，我一步步跟你聊。

1️⃣ Skill到底长啥样？

每个Skilldou有一份 SKILL.md，里面写着名字、描述、使用场景和资源文件列表。

下面这段就是典型例子：

# Code Review
## 何时使用
当用户需要对代码进行审查时使用此技Neng，包括 Bug 排查、代码风格检查、Zui佳实践建议等。
## 审查步骤.
阅读代码，理解其意图.
对照 references/style-guide.md 检查风格问题.
运行 scripts/lint-check.sh 进行静态分析.
输出结构化的审查报告
Skill directory: /home/user/.agents/skills/code-review
此技Neng中的相对路径均相对于上述目录。

  scripts/lint-check.sh
  references/style-guide.md
  references/common-bugs.md

2️⃣ 把Skill目录扫出来——全局 vs 项目局部

一般有两套路径：

/home/用户/.agents/skills/ —— 全局共享，所有客户端douNengkan到。

项目根目录/.agents/skills/ —— 项目专属，只在当前仓库有效。

所以在启动Agent前，要遍历这两个位置，找出所有包含 SKILL.md 的子目录。

3️⃣ 读取并解析SKILL.md元信息

这里建议用轻量的XML或JSON格式把信息塞进系统提示词里。

比如：

  
    code-review
    Review code for bugs, style issues, and best practices.
    /home/user/.agents/skills/code-review/SKILL.md
  
  

不对不对，这段应该是放在系统提示词的开头，让模型一启动就知道自己有哪些“超Neng力”。

4️⃣ 渐进式披露——别一次性塞满上下文！

你要是一次性把所有Skill正文和资源文件dou丢进去，那上下文窗口立刻被占满，后面业务链根本没空间继续推理。

所以采用“渐进式披露”。先只放元信息，等到用户真正请求某个Skill时再读取对应的正文和资源文件。

5️⃣ 用子智Neng体跑Skill——保持主Agent干净利落

A：用户输入触发了某个Skill。 B：我们创建一个子智Neng体，把「用户输入 + Skill元信息」塞进去。 C：子智Neng体内部完成读取、执行、返回结果。 D：主Agent只收到Zui终答案，不会被中间过程污染。

CIA，这种模式好处多：

#隔离：子智Neng体Ke以单独配置工具白名单。

#安全：只让受信任的Skill跑子智Neng体，防止恶意脚本泄密。

#灵活：不同SkillKe以设不同阈值，一旦任务耗时或复杂度超标，就自动委托子智Neng体处理。

6️⃣ 资源文件怎么读？别忘记限制大小！

Said earlier，我们会把 Skill 文件夹下的 /reference、/scripts、/assets`全盘读一遍，然后填进 `` 标签里。不过啊，这里一定要控制列表大小，否则模型一次性拿太多会卡死。 一句话概括：“当前列表可Neng不完整，请自行检查”。这样模型在后续运行时就会主动去补全缺失资源，而不是盲目假设自己Yi经拥有全部文件。

开发实战：Claude Agent SDK 快速集成示例

"""SDK 封装 - 简化版"""
from pathlib import Path
from app.config import RuntimeConfig
ALLOWED_TOOLS = 
def build_client:
    try:
        from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
    except ImportError:
        raise RuntimeError
    options = ClaudeAgentOptions(
        setting_sources=,
        allowed_tools=ALLOWED_TOOLS,
        model="deepseek-chat",
        env={
            "ANTHROPIC_AUTH_TOKEN": config.api_key,
            "ANTHROPIC_BASE_URL": config.base_url,
        },
        add_dirs=
    )
    return ClaudeSDKClient

#小贴士：

#Ru果你用不到Claude，也Ke以换成ClaudeCode或Anthropic兼容的API，只要保持Tool接口一致即可。

#为了防止路径错位，我建议再加一个 “listFiles” 工具，让模型自行检查并修复读取错误。

#YAML解析时别太苛刻，小错误直接返回警告，不要让整个Skill加载失败。

安全与信任检查——别让恶意脚本偷走密钥！

Ehh，你以为随便装个Skill就完事儿？不对不对，还得Zuo信任校验。

* 在项目配置里列出受信任的 Skill 名单。 * 加载前验证 SKILL.md 中是否出现敏感字段。 * 若检测到可疑内容，就抛出警告，让开发者手动确认是否加载。

收尾小感想——从“发现”到“管理”，一步到位！

说实话，这套流程kan起来有点儿多，但真玩起来hen顺手。 你只需要：

#在 ~/.agents/skills 或项目 .agents/skills 放好符合规范的 Skill 包；

#启动 Agent 前让 SDK 自动扫描；

#在系统提示词里注入元信息；

#按需渐进式加载正文和资源；

#必要时交给子智Neng体执行。

#搞定！以后你的 Agent 就Neng像装了外挂一样，从代码审查到 Git 提交，从文档生成到数据清洗，全douNeng“一键搞定”。哈哈，祝你玩得开心~ 🎉🚀

---