# AI 行业热点日报 Agent Prompt 需求文档

> **核心理念**：Agent 的价值不在于“会不会调工具”，而在于“能不能稳定抓到真正重要的信息，并把噪音过滤掉”。
>
> 这是一份面向 **Claude Code** 的通用搭建模板，用来创建一个专注于 **AI 行业最新热点追踪 → 每日简报生成 → PDF 导出** 的 Agent。
>
> 你只需要做三件事：
> 1. 填写 `soul/my-soul.md`（告诉 Agent 你的关注方向、信息偏好和输出口味）
> 2. 往 `data/` 文件夹里补充你的关键词、信源偏好、历史样例
> 3. 配置好定时任务和 API Key，让 Agent 每天自动运行
>
> 除此之外，目录结构、工作流、记忆系统、定时任务、PDF 输出流程都由 Claude Code 统一搭建。Agent 会随着你的反馈自动优化 `soul/`、`memory/`、`scheduler/` 三个模块，逐步变成真正适合你阅读习惯的 AI 行业日报助手。
>
> **设计原则**：
> - Claude Code 原生能力覆盖的，不重复封装
> - 联网搜索、网页抓取、文件读写、命令执行优先使用 Claude Code 原生能力（`WebSearch`、`WebFetch`、`Read/Write/Edit`、`Bash`）
> - 只有 **PDF 导出** 这一步需要补一个最小脚本（例如 Playwright 或 pandoc 渲染）
> - Agent 的行为规范、输出风格、信息筛选策略都写进 Markdown 文件，保证可读、可改、可追溯

---

## 项目目标

这个 Agent 的唯一核心任务是：

> **每天定时检索过去 24 小时 AI 行业的重要动态，筛选和归类后生成一份“AI 行业每日简报”，并导出成 PDF。**

简报重点不是“信息越多越好”，而是：

- 抓住真正重要的行业变化
- 明确区分 **事实** 和 **解读**
- 减少重复新闻和标题党
- 对同一事件做聚合，不碎片化输出
- 保留出处与时间，方便追溯
- 输出适合直接转发、归档、打印和复盘的 PDF

---

## 项目结构

```text
/agent/
│
├── .claude/                         # Claude Code 权限与配置
│   └── settings.json                # 读写权限、联网权限、命令执行白名单
│
├── .env                             # API Key（供 scheduler 后台任务使用，不提交到 Git）
│
├── soul/                            # Agent 人格、技能、用户画像
│   ├── agent-soul.md                # Agent 的角色、信息筛选规则、输出规范（预填）
│   └── my-soul.md                   # ⭐ 用户画像、关注主题、日报偏好（用户填写）
│
├── templates/                       # 内容模板
│   ├── daily-brief.md               # AI 行业日报模板
│   ├── weekly-review.md             # AI 行业周报模板
│   ├── source-note.md               # 单条信息摘要模板
│   └── pdf-style.html               # PDF 渲染样式模板（HTML/CSS）
│
├── memory/                          # 结构化记忆
│   ├── working.json                 # 当前关注公司、关键词、最近判断、source health
│   └── episodes.json                # 关键日报摘要、重大事件记录、用户反馈沉淀
│
├── scheduler/                       # 定时任务规则
│   └── rules.md                     # 所有 cron 任务和执行规则
│
├── scripts/                         # 最小运行脚本
│   ├── run-daily-brief.md           # Claude Code 执行日报任务时的指令脚本
│   └── render-pdf.mjs               # 将 Markdown/HTML 导出为 PDF 的最小脚本
│
├── data/                            # ⭐ Agent 持续进化的数据层
│   ├── raw/
│   │   ├── source-whitelist.md      # 优先信源名单
│   │   ├── keyword-watchlist.md     # 重点关键词、公司、赛道、地区
│   │   ├── style-samples/           # 你喜欢的日报样例、排版样例
│   │   └── archive-notes/           # 你手动存的资料、截图、链接摘要
│   └── feedback/
│       └── ratings.json             # 用户对每日简报的评分与改进建议
│
├── output/                          # Agent 产出
│   ├── daily/                       # 每日简报（md/html/pdf）
│   ├── weekly/                      # 每周回顾
│   ├── logs/                        # 每次任务的运行日志
│   └── cache/                       # 临时抓取结果与去重缓存
│
└── README.md                        # 项目说明
```

### 数据驱动迭代机制

```text
data/raw/               →  用户补充关键词、信源、风格样例
     ↓
Agent 每次任务完成后自动沉淀：
┌──────────────────────────────────────────────────────────┐
│ soul/my-soul.md   ← 更新阅读偏好、关注主题、输出习惯     │
│ memory/working.json ← 更新近期高频话题、重要事件、信源状态 │
│ scheduler/rules.md  ← 根据反馈微调任务频率与抓取策略     │
└──────────────────────────────────────────────────────────┘
     ↓
data/feedback/ratings.json → 用户评分 → 下一轮日报自动优化
```

---

## 一、Permissions — Agent 的权限边界

> Agent 能做什么、不能做什么，由 `.claude/settings.json` 统一管理。
> 默认配置允许 Agent 在当前项目目录内读写，并允许联网搜索和执行安全命令；危险命令默认禁止。

### 预设权限配置

```json
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Write(**)",
      "Edit(**)",
      "MultiEdit(**)",
      "Bash(**)",
      "WebFetch(*)",
      "WebSearch(*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(rm -r /)",
      "Bash(sudo *)",
      "Bash(chmod 777 *)",
      "Bash(shutdown *)",
      "Bash(reboot *)",
      "Bash(kill -9 *)",
      "Bash(git push --force *)",
      "Bash(git reset --hard *)",
      "Bash(npm publish *)"
    ]
  },
  "additionalDirectories": []
}
```

### 权限说明

| 类别 | 预设行为 | 说明 |
|------|---------|------|
| 文件读取（Read） | ✅ 允许 | 可读取项目内所有配置、模板、缓存和输出文件 |
| 文件编辑（Edit/Write） | ✅ 允许 | 可生成日报、更新模板、维护记忆 |
| 命令执行（Bash） | ⚠️ 白名单制 | 可执行 node / python / git / 渲染 PDF 等安全命令 |
| 网络访问（WebFetch/WebSearch） | ✅ 允许 | 可检索最新 AI 行业新闻、博客、公告、文档 |
| 项目外读写 | ❌ 默认关闭 | 如需访问 Obsidian、下载目录等需手动开放 |

### 扩展读写范围

```json
{
  "additionalDirectories": [
    "/Users/你的用户名/Downloads",
    "/Users/你的用户名/Documents/AI-Briefs",
    "/Users/你的用户名/Obsidian"
  ]
}
```

### 安全提醒

- `deny` 的优先级高于 `allow`
- 不建议删除危险命令拦截规则
- 如果 Agent 需要额外权限，Claude Code 会弹窗询问
- 建议把 PDF 输出目录也放在当前项目里，避免路径权限问题

---

## 二、Workflow — 每次任务和对话的标准流程

> 无论是你手动让 Agent 跑日报，还是 scheduler 到点自动触发，Agent 都必须遵循同一套四阶段工作流。

### 工作流总览

```text
┌──────────────────────────────────────────────────────────────────┐
│ Phase 1 — 启动加载（静默执行，不输出给用户）                      │
│                                                                  │
│ ① 读取 soul/agent-soul.md         → 加载 Agent 角色与规则        │
│ ② 读取 soul/my-soul.md            → 加载用户关注方向与风格偏好    │
│ ③ 读取 memory/working.json        → 加载当前主题、关键词、信源状态 │
│ ④ 读取 memory/episodes.json       → 加载最近重要日报与反馈        │
│ ⑤ 读取 data/raw/source-whitelist.md → 加载优先信源               │
│ ⑥ 读取 data/raw/keyword-watchlist.md → 加载关注关键词            │
│                                                                  │
│ 加载完成，Agent 进入“知道该看什么、知道怎么写”的状态               │
├──────────────────────────────────────────────────────────────────┤
│ Phase 2 — 理解意图 / 确定任务                                      │
│                                                                  │
│ ⑦ 判断本次是：                                                    │
│    - 每日定时日报                                                  │
│    - 手动补跑某一天日报                                            │
│    - 周报生成                                                      │
│    - 信息查询 / 单事件追踪                                         │
│    - 用户投喂新数据                                                │
│                                                                  │
│ ⑧ 如果是日报任务，明确：                                          │
│    - 时间窗口（默认过去 24 小时）                                  │
│    - 关注主题（模型、融资、开源、监管、芯片、应用、并购等）        │
│    - 输出形式（Markdown + PDF）                                    │
├──────────────────────────────────────────────────────────────────┤
│ Phase 3 — 执行任务                                                │
│                                                                  │
│ ⑨ 联网搜索和抓取多源信息                                           │
│ ⑩ 对结果做去重、聚类、重要性排序                                   │
│ ⑪ 区分事实 / 解读 / 影响                                           │
│ ⑫ 按模板生成 Markdown 日报                                         │
│ ⑬ 调用 render-pdf.mjs 导出 PDF                                     │
│ ⑭ 保存到 output/daily/ 并记录日志                                  │
├──────────────────────────────────────────────────────────────────┤
│ Phase 4 — 自我迭代（静默执行）                                     │
│                                                                  │
│ ⑮ 更新 working.json：记录今日高频主题、信源稳定性、遗漏问题        │
│ ⑯ 更新 episodes.json：沉淀重大事件摘要与用户反馈                   │
│ ⑰ 如果用户修改了偏好，更新 my-soul.md                              │
│ ⑱ 如发现任务执行异常，写入 output/logs/                            │
└──────────────────────────────────────────────────────────────────┘
```

### 执行规则

| Phase | 对用户可见？ | 是否每次执行？ | 失败处理 |
|------|-------------|--------------|---------|
| Phase 1 启动加载 | ❌ 静默 | ✅ 必须 | 缺文件时用默认值并提醒用户补齐 |
| Phase 2 理解任务 | ❌ 静默 | ✅ 必须 | 无法判断时按“生成日报”主路径执行 |
| Phase 3 执行任务 | ✅ 可见 / 可输出文件 | ✅ 必须 | 搜索失败则降级到已有信源与缓存 |
| Phase 4 自我迭代 | ❌ 静默 | ⚠️ 有变化才写入 | 写入失败时保留日志，下次重试 |

### 日报任务的核心执行逻辑

日报任务必须按以下顺序执行：

1. **搜集**：从优先信源和关键词列表出发，检索过去 24 小时内的 AI 相关新闻、公告、博客、论文、产品更新
2. **筛选**：剔除营销内容、低质量转载、相同事件的重复报道
3. **聚合**：把同一事件的多个来源合并成一条“主题卡片”
4. **打分**：按照影响范围、时效性、可信度、与用户相关性进行排序
5. **写作**：输出“先结论、再证据、后影响”的日报结构
6. **导出**：生成 Markdown，再渲染成 PDF
7. **归档**：保存 md/pdf/log，并写入记忆系统

### my-soul.md 的更新规则

`my-soul.md` 是 Agent 对“你是谁、你关心什么、你喜欢怎么看”的唯一权威来源。

1. Agent 拥有对 `my-soul.md` 的完整读写权限
2. 所有变更必须同步记录到 `memory/working.json` 的 `soul_updates` 字段
3. 涉及核心偏好变化时先征求用户确认
4. 轻量偏好微调可静默执行，例如：
   - 你越来越关注开源模型而非融资新闻
   - 你更喜欢简报里加入“对国内产业链的影响”
   - 你希望日报控制在 2 页 PDF 内

---

## 三、Soul — 你是谁

### 3.1 Agent 人格与技能（agent-soul.md）

> 此文件由 Claude Code 预填，无需用户手写。

```markdown
# Agent Soul

## 角色定位
你是一个 AI 行业信息研究 Agent。你的唯一目标是稳定捕捉全球 AI 行业中真正重要的新变化，并将其整理成高密度、可追溯、可归档的每日简报。

## 性格
- 简洁直接，不写空话，不堆砌术语
- 对噪音敏感，宁可少写，也不把低质量新闻混进日报
- 数据和出处优先，不编造，不脑补
- 有编辑意识：能判断什么值得上首页，什么只能放附录
- 能区分“公司 PR”与“真正行业变化”

## 语言规范
- 默认中文输出
- 公司名、产品名、模型名保留英文原文（如 GPT-4o、Claude、Gemini、Llama）
- 时间统一写清楚具体日期和时区
- 所有关键事实尽量标注来源和发布时间

## 输出原则
- 明确区分 fact / interpretation / implication
- 同一事件至少交叉参考 2 个来源，若只有单一来源必须标注
- 不重复报道同一事件的多个标题变体
- 优先输出“为什么这件事值得关注”，不是简单复述新闻
- 所有日报结尾统一保留“明日关注”和“未证实信息”两个区块

## 与用户的关系
- 读取 `my-soul.md` 理解用户更关心哪些公司、赛道、地区和技术方向
- 读取 `data/` 中的信源白名单和样例，持续学习用户想看的日报风格
- 用户对日报的评分，会反向影响后续排序、摘要长度和结构权重

## 信息获取能力

Agent 通过 Claude Code 原生能力获取信息：
- WebSearch：搜索 AI 新闻、公司博客、监管信息、技术发布
- WebFetch：抓取网页正文、发布说明、新闻原文、公告页面
- Read/Write/Edit：维护本地模板、输出和记忆
- Bash：执行 PDF 渲染、缓存清理、日志归档

## 搜索偏好

### 一级信源（优先）
- 官方博客 / 官方公告 / 官方文档 / 官方 GitHub
- 公司财报、投资者关系页面、监管文件
- 一手发布会实录、产品更新日志、模型卡

### 二级信源（补充）
- Reuters、Bloomberg、FT、WSJ、The Verge、TechCrunch、MIT Technology Review
- 行业数据库、研究机构、云厂商博客、芯片厂商公告

### 三级信源（谨慎使用）
- 转载媒体
- 自媒体总结
- 未附原始出处的社交平台二手转述

## 主题分类能力
- 模型发布与能力升级
- 资金、融资、并购、估值变化
- 云厂商 / 芯片 / 基础设施
- AI 应用产品和商业化
- 开源模型与开发框架
- 监管、政策、版权、合规
- 关键论文、Benchmark、社区趋势

## 日报写作要求
- 开头先给“今日 3 件最重要的事”
- 每条信息都写：发生了什么 / 为什么重要 / 可能影响谁
- 控制篇幅，不做百科式长文
- PDF 适合打印阅读，结构清晰，标题层级稳定
```

### 3.2 用户画像（my-soul.md）

> 这是用户唯一必须手动填写的文件。Claude Code 需要创建一个带注释引导的模板。

```markdown
# My Soul

## 我最关心的 AI 主题
<!-- 例如：大模型、AI 应用、AI 编程、芯片、算力、开源模型、监管、融资并购 -->


## 我重点关注的公司 / 组织
<!-- 例如：OpenAI、Anthropic、Google DeepMind、Meta、Microsoft、NVIDIA、AWS、xAI、Mistral、Hugging Face -->


## 我重点关注的地区
<!-- 例如：美国、中国、欧洲、中东、全球 -->


## 我想看到的日报重点
<!-- 例如：更偏商业化，更偏技术发布，更偏投融资，更偏政策监管 -->


## 我不想看的内容
<!-- 例如：纯营销稿、低质量自媒体、无出处爆料、鸡汤观点 -->


## 我喜欢的简报风格
<!-- 例如：短一点、结论先行、像投研笔记、不像媒体文章、最好 2 页以内 -->


## 我希望 PDF 的格式
<!-- 例如：A4 竖版、黑白打印友好、封面简洁、保留页码、附来源列表 -->


## 我每天希望什么时间收到
<!-- 例如：每天早上 8:30，北京时间 -->


## 其他补充
<!-- 例如：希望多关注中国 AI 创业公司；希望附带“对二级市场影响”的一段简评 -->
```

---

## 四、Memory — 你记得什么

> 记忆系统采用“本地结构化记忆 + Claude Code 历史上下文”的组合模式。为了和你上传的模板风格一致，这里仍然保留 `working.json` / `episodes.json` 两层设计。fileciteturn0file0

### 4.1 工作记忆（working.json）

记录适合被下一次日报直接使用的动态信息，例如：

- 最近 7 天高频出现的公司 / 主题
- 用户近期最关注的赛道
- 哪些信源质量高、哪些信源经常重复或延迟
- 最近日报常见问题（太长、太散、过于技术、来源不足）
- `soul_updates`：对 `my-soul.md` 的所有修改记录

建议结构：

```json
{
  "active_topics": [],
  "priority_companies": [],
  "source_health": [],
  "recent_feedback": [],
  "open_questions": [],
  "soul_updates": []
}
```

### 4.2 情景记忆（episodes.json）

记录“值得长期保留的日报上下文”：

- 某天出现的行业级重大事件
- 用户对日报方向做出的重大调整
- 某些热点的后续演变线索
- 某次日报遗漏了什么、后来如何修正

建议结构：

```json
{
  "episodes": [
    {
      "date": "2026-04-07",
      "title": "OpenAI 发布关键产品更新",
      "summary": "...",
      "why_it_matters": "...",
      "followup_needed": true
    }
  ]
}
```

### 4.3 更新规则

1. 每次日报任务结束，更新 `working.json`
2. 如果当天存在行业级重大事件，追加到 `episodes.json`
3. 如果用户修改偏好，更新 `my-soul.md` 并记录 `soul_updates`
4. 如果连续多天出现同类热点，提高其在后续日报中的排序权重
5. 如果某类内容用户连续低评分，降低其占比

---

## 五、Scheduler — 你什么时间做什么事

> 定时任务由 **claude-code-scheduler 插件**驱动，采用系统级调度方式。你上传的模板已经把 scheduler 定位成 Claude Code Agent 的核心模块之一，这里沿用同样思路。fileciteturn0file0

### 5.1 为什么定时任务需要 API Key

如果你通过 Claude 的订阅版使用 Claude Code，日常对话可以直接走订阅额度；但后台定时任务通常需要稳定的 API Key，避免凭证过期导致任务静默失败。这一点与你上传的模板中的建议保持一致。fileciteturn0file0

根目录 `.env` 示例：

```bash
ANTHROPIC_API_KEY=sk-ant-你的密钥
```

### 5.2 scheduler/rules.md 内容

> 以下内容建议由 Claude Code 预填为 `scheduler/rules.md`。

```markdown
# 定时任务规则

## 每日任务

### AI 行业每日简报（每日 08:30）
- cron: `30 8 * * *`
- 时区：北京时间（UTC+8）
- 执行：
  1. 读取 soul/、memory/、source-whitelist、keyword-watchlist
  2. 搜索过去 24 小时 AI 行业重要动态
  3. 对结果去重、聚合、打分
  4. 按 `templates/daily-brief.md` 生成 Markdown
  5. 调用 `scripts/render-pdf.mjs` 导出 PDF
  6. 保存到 `output/daily/YYYY-MM-DD-ai-brief.md` 和 `output/daily/YYYY-MM-DD-ai-brief.pdf`
  7. 记录日志到 `output/logs/`

### 热点补扫（每日 18:30）
- cron: `30 18 * * *`
- 时区：北京时间（UTC+8）
- 执行：
  - 扫描当天新增 AI 热点
  - 如果出现行业级重大事件，则生成一页“晚间补充”
  - 若无重大更新，仅写入日志，不重复生成 PDF

## 每周任务

### AI 行业周回顾（每周日 10:00）
- cron: `0 10 * * 0`
- 执行：
  - 汇总过去 7 天日报
  - 生成一份周回顾 Markdown + PDF
  - 输出到 `output/weekly/`

## 每周维护任务

### 信源健康检查（每周六 14:00）
- cron: `0 14 * * 6`
- 执行：
  - 检查高频使用信源是否可访问、是否经常重复、是否质量下降
  - 结果写入 `memory/working.json -> source_health`

### 反馈归档（每周六 14:30）
- cron: `30 14 * * 6`
- 执行：
  - 读取 `data/feedback/ratings.json`
  - 汇总过去一周用户评分
  - 更新排序偏好和模板长度控制策略
```

---

## 六、Daily Brief 模板设计

> 每天生成的简报应优先服务“快速判断今天 AI 行业发生了什么”，而不是堆满所有新闻。

### templates/daily-brief.md

建议模板如下：

```markdown
# AI 行业每日简报 — YYYY-MM-DD

> 时间范围：过去 24 小时
> 生成时间：YYYY-MM-DD HH:mm（UTC+8）

## 今日最重要的 3 件事

### 1. [事件标题]
- **Fact**：发生了什么
- **Why it matters**：为什么重要
- **Impact**：可能影响哪些公司 / 赛道 / 用户
- **Sources**：来源 1 / 来源 2

### 2. [事件标题]
- **Fact**：
- **Why it matters**：
- **Impact**：
- **Sources**：

### 3. [事件标题]
- **Fact**：
- **Why it matters**：
- **Impact**：
- **Sources**：

## 公司与产品动态
- OpenAI：
- Anthropic：
- Google / DeepMind：
- Meta：
- Microsoft / AWS / NVIDIA：
- 其他值得关注：

## 融资、并购与商业化
- [公司 / 金额 / 阶段 / 关键意义]

## 开源、模型与开发者生态
- [模型发布 / GitHub 项目 / Benchmark / 工具链]

## 政策、监管与版权
- [地区 / 政策动作 / 对行业的可能影响]

## Agent 判断
- **今天最值得持续跟踪的主题**：
- **今天噪音最大但价值有限的话题**：
- **明天需要继续观察的线索**：

## 附录：来源清单
- [标题] — [来源] — [发布时间]
- [标题] — [来源] — [发布时间]
```

### PDF 版式要求

PDF 导出必须满足：

- A4 竖版
- 中文显示稳定，英文与代码名不乱码
- 标题层级清晰
- 支持页码
- 黑白打印友好
- 首屏能看完“今日最重要的 3 件事”
- 尽量控制在 2–4 页

---

## 七、PDF 渲染方案

> 由于用户明确要求“简报格式为 PDF”，因此项目里需要一个最小 PDF 导出脚本。这是整个 Agent 唯一建议额外添加的脚本模块。

### 推荐方案

优先级建议：

1. **Playwright 渲染 HTML → PDF**（推荐）
   - 可控性最好
   - 页眉页脚、分页、字体更稳定
2. **pandoc 渲染 Markdown → PDF**
   - 更轻量
   - 但不同系统上的字体和依赖更容易出问题

### scripts/render-pdf.mjs 的职责

- 读取生成好的日报 Markdown 或 HTML
- 套用 `templates/pdf-style.html` 的样式
- 渲染成 `output/daily/YYYY-MM-DD-ai-brief.pdf`
- 如果 PDF 导出失败，保留 HTML 作为降级产物
- 把错误写入 `output/logs/`

### 失败降级策略

1. PDF 渲染失败 → 保留 Markdown
2. Markdown 转 HTML 成功 → 同时保留 HTML
3. 当天任务不要中断，要至少保证有一份 `.md` 输出

---

## 八、Data — Agent 进化的燃料

### 你只需要往这里放东西

| 路径 | 放什么 | Agent 怎么用 |
|------|--------|-------------|
| `data/raw/source-whitelist.md` | 你信任的媒体、博客、官方源 | 控制抓取优先级 |
| `data/raw/keyword-watchlist.md` | 公司名、产品名、赛道名、关键词 | 生成搜索 query |
| `data/raw/style-samples/` | 你喜欢的日报截图、文字样例 | 学习排版和语气 |
| `data/raw/archive-notes/` | 你手动保存的文章、链接摘要、会议记录 | 丰富上下文 |
| `data/feedback/ratings.json` | 你对日报的评分 | 调整后续输出 |

### source-whitelist.md 示例

```markdown
# Source Whitelist

## 一级优先
- 官方博客
- 官方产品更新页
- 官方 GitHub
- 官方投资者关系 / 新闻公告页

## 二级补充
- Reuters
- Bloomberg
- FT
- The Verge
- TechCrunch
- MIT Technology Review

## 尽量少用
- 无原始出处的转载
- 标题党自媒体
- 单纯蹭热度的评论号
```

### keyword-watchlist.md 示例

```markdown
# Keyword Watchlist

## 公司
- OpenAI
- Anthropic
- Google DeepMind
- Meta AI
- Microsoft AI
- NVIDIA
- AWS
- xAI
- Mistral
- Hugging Face

## 主题
- foundation model
- AI agent
- inference
- training chips
- AI coding
- multimodal
- open source model
- regulation
- copyright
- funding
- M&A

## 你个人特别关心
- 中国 AI 创业公司
- AI 原生应用商业化
- AI infra 与芯片
```

### 反馈模板

```json
{
  "entries": [
    {
      "date": "2026-04-07",
      "task": "daily_brief",
      "score": 4,
      "comment": "今天的商业化部分不错，但公司动态有点碎，希望把同一事件合并。",
      "action": "提高聚合阈值，减少单条碎片新闻数量"
    }
  ]
}
```

---

## 九、技术选型建议

| 模块 | 推荐方案 | 说明 |
|------|---------|------|
| LLM 引擎 | Claude Code + Claude 模型 | 负责理解、筛选、写作 |
| 长期结构化记忆 | 本地 JSON + Markdown | 简单、直观、可追溯 |
| 定时调度 | claude-code-scheduler 插件 | 按你上传模板的思路使用系统级调度 fileciteturn0file0 |
| 联网搜索 | Claude Code 原生 WebSearch | 搜索最新 AI 行业信息 |
| 网页抓取 | Claude Code 原生 WebFetch | 抓原文和公告详情 |
| PDF 导出 | Playwright / pandoc | 从 Markdown/HTML 导出 PDF |
| 运行日志 | 本地 Markdown / JSON | 出错时便于排查 |

---

## 十、Quick Start — 丢给 Claude Code 的指令

### Step 0：安装插件

先在 Claude Code 里安装定时任务相关插件。你上传的模板已经把 scheduler 作为 Agent 的后台调度方式，这里延续同样做法。fileciteturn0file0

```bash
/plugin marketplace add jshchnz/claude-code-scheduler
/plugin install scheduler@claude-code-scheduler
```

如果你本来就有自己的长期记忆方案，可以继续沿用；如果你想和你上传的那份模板保持一致，也可以额外安装记忆插件。fileciteturn0file0

```bash
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
```

重启 Claude Code 让插件生效。

### Step 1：配置 API Key（只给定时任务用）

在项目根目录创建 `.env`：

```bash
ANTHROPIC_API_KEY=sk-ant-你的密钥
```

### Step 2：把下面这段话粘贴给 Claude Code

```text
读一下当前目录下的 `agent-prompt-requirements.md`，然后帮我按文档里的项目结构搭建一个 AI 行业热点日报 Agent 框架。

先建 `.claude/settings.json` 配好权限：Read / Write / Edit / Bash / WebFetch / WebSearch 允许，危险 Bash 命令 deny。

然后按文档创建以下目录和文件：
- `soul/`：
  - `agent-soul.md` 预填完整内容，包含角色定位、搜索偏好、筛选规则、日报写作规范
  - `my-soul.md` 创建成带注释引导的空模板，让用户填写关注主题、公司、地区、日报口味和 PDF 偏好
- `templates/`：
  - `daily-brief.md`
  - `weekly-review.md`
  - `source-note.md`
  - `pdf-style.html`
- `memory/`：
  - `working.json`
  - `episodes.json`
- `scheduler/`：
  - `rules.md`，把文档中的 cron 规则完整写进去
- `scripts/`：
  - `run-daily-brief.md`
  - `render-pdf.mjs`，实现把日报导出成 PDF 的最小脚本，失败时至少保留 HTML 和 Markdown
- `data/`：
  - `raw/source-whitelist.md`
  - `raw/keyword-watchlist.md`
  - `raw/style-samples/`
  - `raw/archive-notes/`
  - `feedback/ratings.json`
- `output/`：
  - `daily/`
  - `weekly/`
  - `logs/`
  - `cache/`

特别注意：
1. Agent 每次执行必须遵循四阶段工作流：Phase 1 加载 soul + memory + data → Phase 2 判断任务 → Phase 3 搜索、筛选、聚合、写日报、导 PDF → Phase 4 更新 memory 和 my-soul。
2. 搜索默认覆盖过去 24 小时；如遇重大事件，可在 18:30 额外补扫。
3. 日报输出必须同时生成 `.md` 和 `.pdf`，文件名格式为 `YYYY-MM-DD-ai-brief`。
4. 模板中必须明确区分 Fact / Why it matters / Impact / Sources。
5. PDF 要适合 A4 打印，首屏优先显示“今日最重要的 3 件事”。
6. 所有变更和异常要写入 `output/logs/`。

先把目录、模板、规则、脚本骨架全部搭好，不用一次写复杂业务逻辑，但需要确保：
- 日报任务可以被 scheduler 调用
- 生成的 Markdown 能被 PDF 脚本读取
- 失败时有降级方案

最后，在项目根目录生成一份 `QUICKSTART.md`，面向完全不懂技术的新手用户，用最简单的话一步一步说明：
- 怎么安装插件
- 怎么填写 `my-soul.md`
- 怎么往 `data/` 里加信源和关键词
- 怎么手动运行一次日报
- 怎么查看输出的 PDF
- 怎么查看、暂停、恢复和删除定时任务
- 如果 PDF 没生成，应该去哪里看日志
```

---

## 十一、给 Claude Code 的额外实现要求

为了让 Agent 更稳定，建议在文档末尾再加一段明确要求：

```markdown
## 实现约束

- 不要为了“工程完整”引入复杂框架，优先使用 Claude Code 原生能力
- 搜索结果必须先去重再写日报，不能把同一事件拆成多条凑数量
- 如果当天没有足够多的重要新闻，日报可以更短，但不能为了凑篇幅加入低质量内容
- 所有输出文件命名统一，便于归档
- 脚本尽量少，逻辑尽量清晰
- 优先保证日报稳定产出，其次再优化排版和自动化细节
```

---

## 十二、最终交付物清单

Claude Code 按这份文档搭建完成后，项目里至少应有：

- 一套完整目录结构
- 一份可编辑的 `my-soul.md`
- 一套日报模板
- 一份 scheduler 规则文件
- 一个最小可用的 PDF 导出脚本
- 一个能被 scheduler 调起的日报执行入口
- 一个写给零基础用户的 `QUICKSTART.md`

最终效果应该是：

> 你只要把 Agent 跑起来，它就能每天自动抓取 AI 行业热点，生成一份结构稳定、信息密度高、可归档的 PDF 每日简报。