Agent开发（五）：skills的加载

skills/send-email/
├── SKILL.md                 # 必须有
└── references/template.md   # 模板、细则，按需再读

---
name: send-email
description: 起草并确认邮件。用户要发邮件、写邮件、回复邮件时使用。
---

# 发邮件

按这个顺序做，不要跳步：

1. 确认收件人、主题、目的。缺了就问，不要编。
2. 调用 read_skill_file，name 为 send-email，path 为 references/template.md，按里面的格式起草正文。
3. 把草稿给用户确认。用户没明确同意之前，不要说已经发出。
4. 用户同意后，给出最终邮件。这里只生成草稿，不真正发送。

# 获取到目录下所有skills的描述、body、dir
def load_skills():
    skills = {}
    for path in sorted(SKILLS_DIR.glob("*/SKILL.md")):
        text = path.read_text(encoding="utf-8")
        front, _, body = text.removeprefix("---").partition("---")
        meta = {}
        for line in front.splitlines():
            if ":" not in line:
                continue
            key, value = line.split(":", 1)
            meta[key.strip()] = value.strip()
        skills[meta["name"]] = {"description": meta["description"], "body": body.strip(), "dir": path.parent}
    return skills

def dynamic_system_prompt(agent, system_prompt: str) -> str:
    catalog = "\n".join(f"- {name}: {skill['description']}" for name, skill in SKILLS.items())
    loaded = "".join(f"\n\n## 已加载 skill：{name}\n{body}" for name, body in agent.loaded_skills.items())
    return (
        f"{system_prompt}当前的系统时间是：{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}。\n\n"
        f"可用 skills，匹配到用户任务时先调用 load_skill，不要凭记忆执行：\n{catalog}{loaded}"
    )

# 加载skill
def load_skill(agent, args):
    name = args.get("name", "")
    skill = SKILLS.get(name)
    if skill is None:
        return f"没有这个 skill，可用的有：{', '.join(SKILLS)}"
    agent.loaded_skills[name] = skill["body"]
    return f"已加载 {name}，按系统提示词里的步骤执行"

# 读取skill文件/附件
def read_skill_file(args):
    skill = SKILLS.get(args.get("name", ""))
    if skill is None:
        return "没有这个 skill"
    root = skill["dir"].resolve()
    target = (root / args.get("path", "")).resolve()
    if not target.is_relative_to(root) or not target.is_file():
        return "文件不存在"
    return target.read_text(encoding="utf-8")

> 你好 
你好！我是测试助手，可以帮你：

- **整理会议纪要**：把零散的会议记录整理成规范纪要和待办
- **起草邮件**：帮你写邮件或回复邮件

有需要直接说，或者把内容发给我就行。
> 你能做什么？
我能帮你做两类事：

1. **整理会议纪要** —— 你把会议记录（哪怕是零散的口语化笔记）发给我，我整理成规范纪要，包含结论和待办事项。
2. **起草邮件** —— 告诉我收件人、目的和要点，我帮你写邮件；也可以帮你拟回复。

直接把内容发过来就行。
> 帮我写一封邮件
call_00_mUl2IgjH0t2At7XBhe9w4723 load_skill   {  "  name  "  :   "  send  -  email  "  }
result: call_00_mUl2IgjH0t2At7XBhe9w4723 load_skill {"name": "send-email"} 已加载 send-email，按系统提示词里的步骤执行
好的，起草邮件前我需要先确认三件事：

1. **收件人**：发给谁？（个人/某个部门/客户）
2. **主题**：这封邮件是关于什么的？
3. **目的**：你希望对方读完做什么？（比如确认信息、安排会议、催进度、致谢……）

把这几点告诉我，如果有具体内容要点也一并给我，我就开始起草。
> 发给小王， 主题是学习，目的是让他列学习计划
call_00_yXGIigjwCqu1Etz35lrS1852 read_skill_file   {  "  name  "  :   "  send  -  email  "  ,   "  path  "  :   "  references  /t  emplate  .md  "  }
result: call_00_yXGIigjwCqu1Etz35lrS1852 read_skill_file {"name": "send-email", "path": "references/template.md"} # 邮件模板

收件人：
主题：

正文：
开头用一句说明来意。
中间写要对方做什么，或需要对方知道的事实。
结尾写期望的回复时间。

落款用“测试助手”。

草稿如下，有两处需要你补一下（用【】标出）：

---

**收件人**：小王
**主题**：学习

**正文**：

小王，你好：

关于学习安排，需要你这边先出一份学习计划。

请围绕【学习内容/方向】列出计划，包含学习目标、具体内容和时间节点，于【期望回复时间】前发我。

如有不清楚的地方，随时沟通。

测试助手

---

请补充：
1. **学习内容/方向**（比如某项技术、业务知识、证书考试？）
2. **希望他什么时候前交计划**
3. 是否需要抄送其他人

补上后我给你出最终版本。