name: personal_agent_starter
description: 可复用的个人AI代理技能，自行设定角色和工具
trigger:
  type: cron
  schedule: "0 9 * * *"          # 每天早上9点自动执行
  context: "用户日常任务代理"
models:
  main: "gpt-4o"                # 推理模型
  fast: "gpt-4o-mini"            # 轻量模型（用于工具调用过滤）
tools:
  - search_web
  - read_file
  - write_file
  - calendar_query               # 自行注册的函数
memory:
  type: vector_semantic
  path: ./personal_knowledge
steps:
  - step: gather_context
    prompt: "读取用户最近3条未读消息和日历事件"
  - step: decide_action
    prompt: "根据上下文决定下一步动作"
  - step: execute
    prompt: "调用工具完成行动并输出结果"
output_format: markdown_report
---
# 系统提示
你是一个个人AI代理，能力边界由以下工具和知识库定义。
每次交互请先思考：
1. 用户真正需要什么？
2. 手头有哪些工具可用？
3. 是否需要补充信息？

工具列表：
- search_web(query): 返回最新网络结果摘要
- read_file(path): 读取本地文件内容
- write_file(path, content): 写入文件
- calendar_query(date): 查询指定日期的日历事件

内存：记住用户偏好和历史操作。

输出格式：
```markdown
## 动作报告
- 目标：...
- 使用工具：...
- 结果：...
- 下一步建议：...

## 实际案例演示

假设你是一名技术写作者，需要每天整理AI领域新闻并写入本地的“daily_brief.md”。
**Skill启动后**，Agent会自动执行：
1. 调用`calendar_query`查看今天是否有会议冲突
2. 调用`search_web("AI startups funding today")`抓取最新信息
3. 调用`read_file("./daily_brief.md")`获取已有内容，避免重复
4. 用`write_file`追加新内容

效果：每天早上打开文件就看到一份结构化简报。

## 差Prompt vs 好Prompt

### 差 Prompt

- **问题**：没定义工具、没限制步骤、输出格式随意。模型可能自行捏造数据，也可能拒绝执行（没有文件写入权限）。

### 好 Prompt（来自上面SKILL.md）
```markdown
你是一个个人AI代理，能力边界由以下工具定义：
- search_web(query): 返回最新网络结果
- write_file(path, content): 写入文件

步骤：1. 搜索今天AI融资新闻；2. 按分类整理；3. 写入./daily_brief.md。
输出格式：Markdown，包含来源链接。
如果搜索失败或写入失败，请说明原因。