15.3 CLAUDE.md 与规则文件

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

CLAUDE.md 是整个系统的中枢配置。它定义了目录结构、处理流程、文件路由和任务日志格式，是所有 Skills、Rules 和 Loop 的共同参照。三条 Rules 在此基础上约束具体行为。

CLAUDE.md

本项目的 CLAUDE.md 完整内容如下：

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概述

自动化办公工作区。通过 inbox 投递待处理文档，定时轮询识别并路由到对应 skill 处理。覆盖 Excel 数据分析、会议纪要整理、日报/周报生成、PPT 制作、PDF 解析等场景。

## 目录结构

| 目录 | 用途 |
|------|------|
| inbox/ | 待处理文档投递箱，用户将文件放入此处 |
| tasks/ | 任务工作区，每个任务一个 {YYYY-MM-DD}-{名称}/ 子文件夹，源文件和产出物放在一起 |
| reports/ | 日报、周报、月报 |
| daily/ | 每日文件处理记录，每天一个 {YYYY-MM-DD}.md |
| archive/{YYYY-MM}/ | 已完成任务的长期归档 |
| templates/ | 常用文档模板 |

## Inbox 处理流程

1. 扫描 inbox/ 中的新文件
2. 识别文件类型和任务意图
3. 在 tasks/ 下创建任务文件夹 {YYYY-MM-DD}-{任务名}/
4. 将源文件从 inbox/ 移入任务文件夹
5. 路由到对应 skill 处理，产出物保存在同一任务文件夹
6. 更新 changelog.md、daily/{YYYY-MM-DD}.md、相关目录的 README.md

### 便签系统

用户将文件放入 inbox 后，在对话中说明处理意图。Claude 据此生成便签，记录任务需求和处理方案。便签命名：task-{任务名}.md。多个任务的便签在 inbox 中共存，互不覆盖。任务处理完成后，便签随源文件一起移入任务文件夹，作为任务记录保留。

### 文件路由

| 文件特征 | Skill |
|---------|-------|
| .xlsx / .csv / .tsv（数据分析、报表） | minimax-xlsx |
| .docx（编辑、排版、套模板） | minimax-docx |
| .pdf → Markdown 转换 | mineru |
| .pdf（合并、拆分、提取、表单填写） | pdf |
| 需要高品质设计的 PDF 输出 | minimax-pdf |
| .pptx 或 PPT 相关需求 | pptx-generator |
| 写日报 / 写周报 | work-report |
| 长文档协作撰写 | doc-coauthoring |

多个 PDF skill 的选择：处理现有 PDF（合并、拆分、提取）→ pdf；将 PDF 转为 Markdown → mineru；生成高品质设计 PDF → minimax-pdf。路由歧义时询问用户，不自行猜测。

## 索引体系

三层索引，各有分工：

| 索引 | 位置 | 粒度 | 内容 |
|------|------|------|------|
| changelog.md | 根目录 | 任务级 | 时间、任务名、源文件、产出物、skill、备注 |
| daily/{date}.md | daily/ | 日+文件级 | 当日处理的所有文件清单 |
| README.md | 各目录内 | 目录级 | 该目录下所有条目的摘要索引 |

## Loop 工作流

| Loop | 间隔 | 提示词 | 职责 |
|------|------|--------|------|
| inbox-monitor | 半小时 | .claude/loops/inbox-monitor.md | 扫描 inbox，处理新文件 |
| daily-routine | 24 小时 | .claude/loops/daily-routine.md | 生成日报（含复盘），周五加周报 |

## 命名约定

- 任务文件夹：{YYYY-MM-DD}-{任务名}/（任务名用中文，简洁描述）
- 报告：{YYYY-MM-DD}-日报.md、{YYYY-MM-DD}-周报.md
- 产出物文件名应体现内容，不用通用名如 output.xlsx

这份 CLAUDE.md 的设计有几个要点。文件路由表是核心——它把文件类型和 Skill 的对应关系写死，减少了 AI 猜测的空间。任务日志体系保证每个任务都有据可查：changelog.md 记录全局时间线，daily/ 按天聚合当日处理的所有文件，各目录的 README.md 提供局部导航。便签系统是人机交互的桥梁——用户说意图，AI 生成一张任务卡片（便签），Loop 按卡片上的内容执行。

规则一：inbox-interaction

便签是系统中的任务卡片。当用户把文件放进 inbox/ 并说明处理意图后，AI 会生成一个 Markdown 文件（如 task-销售分析.md），里面记录要处理哪些文件、用户的具体需求、应该调用哪个 Skill。后续 Loop 轮询时，就是通过读取这些便签来了解该做什么。

这条规则约束便签的生成过程。核心要求是必须通过 AskUserQuestion 工具确认用户意图，不能自行猜测。

# 便签生成规则

当用户提到 inbox 中有新文件需要处理时，通过 AskUserQuestion 工具确认意图并生成便签。

## 流程

1. 扫描 inbox/，列出新文件（文件名、类型、大小）
2. 使用 AskUserQuestion 工具向用户提问，收集处理意图和关键细节（如输出格式、语言、风格、篇幅等）
3. 根据用户回答生成便签 inbox/task-{任务名}.md

## 约束

1. 必须使用 AskUserQuestion 工具交互，不要直接假设用户意图
2. 一张便签对应一个任务。多批不相关文件分别生成便签，命名各自独立
3. 便签中必须明确：涉及的文件、用户需求、选定的 skill、处理步骤
4. 生成便签后，询问用户是否立即处理。用户确认后才执行，否则留给 inbox-monitor loop 轮询处理。不得自行决定立即处理
5. inbox-monitor loop 每次扫描时，检查 task-*.md 文件识别待处理任务

便签支持异步批量处理

用户可以一次投递多个文件、生成多张便签，然后离开。Loop 每半小时轮询一次，按便签内容逐个处理。便签处理完后随源文件一起移入任务文件夹，既是执行指令，也是任务记录。

规则二：task-changelog

每完成一个任务，系统需要在三个地方留下记录：changelog.md（全局任务日志，记录所有任务的时间线）、daily/ 目录下的当日文件索引（汇总今天处理了哪些文件）、以及相关目录的 README.md（该目录下有什么内容）。这条规则确保这三处记录同步更新，不会遗漏。

# 任务日志规则

每次完成一个任务（无论是 inbox 自动处理还是手动任务），必须同步更新三处索引。

## 1. changelog.md（根目录）

在表格顶部追加一行（最新的在最上面）：

| 时间 | 任务 | 源文件 | 产出物 | Skill | 备注 |
|------|------|--------|--------|-------|------|

字段要求：
1. 时间精确到分钟：YYYY-MM-DD HH:MM
2. 源文件记录原始文件名
3. 产出物记录相对路径（如 tasks/2026-04-16-销售分析/report.pdf）
4. 任务失败或部分完成也要记录，备注标注"失败"或"部分完成"及原因

## 2. daily/{YYYY-MM-DD}.md

如果当日索引文件不存在，按模板创建，然后追加当前任务涉及的所有文件（源文件和产出物各一行）。

## 3. 相关目录的 README.md

更新 tasks/README.md（新增任务条目）。如果产出物写入了其他目录（如 reports/），同步更新该目录的 README.md。

规则三：daily-review

这条规则要求日报末尾追加复盘章节。复盘基于 changelog.md 的事实记录，回答三个问题。

# 日报复盘规则

生成日报时，在标准日报内容之后，必须追加"今日复盘"章节。

## 复盘内容

基于当天 changelog.md 中的实际处理记录，回答三个问题：

1. 效率回顾：今天的任务处理是否顺利？有没有路由错误、处理失败或反复修改的情况？
2. 经验沉淀：发现了什么值得记住的模式、技巧或注意事项？
3. 改进建议：流程、模板、skill 有没有需要优化的地方？

## 约束

1. 复盘必须基于事实（changelog 记录），不凭空编造
2. 如果发现可复用的经验，建议保存到 memory
3. 如果发现 skill 或规则需要调整，主动提醒用户
4. 当天无任务处理时，复盘章节写"今日无任务处理"

三条规则各管一段：inbox-interaction 管入口——怎么确认用户意图、生成任务卡片；task-changelog 管记录——任务完成后往哪几个地方写日志；daily-review 管复盘——日报末尾回顾当天的效率和经验。

--- title: "15.3 CLAUDE.md 与规则文件" --- ![规则文件协作关系](images/img_03_rules.png) `CLAUDE.md` 是整个系统的中枢配置。它定义了目录结构、处理流程、文件路由和任务日志格式，是所有 Skills、Rules 和 Loop 的共同参照。三条 Rules 在此基础上约束具体行为。 ### CLAUDE.md 本项目的 `CLAUDE.md` 完整内容如下： ```txt # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## 项目概述自动化办公工作区。通过 inbox 投递待处理文档，定时轮询识别并路由到对应 skill 处理。覆盖 Excel 数据分析、会议纪要整理、日报/周报生成、PPT 制作、PDF 解析等场景。 ## 目录结构 | 目录 | 用途 | |------|------| | inbox/ | 待处理文档投递箱，用户将文件放入此处 | | tasks/ | 任务工作区，每个任务一个 {YYYY-MM-DD}-{名称}/ 子文件夹，源文件和产出物放在一起 | | reports/ | 日报、周报、月报 | | daily/ | 每日文件处理记录，每天一个 {YYYY-MM-DD}.md | | archive/{YYYY-MM}/ | 已完成任务的长期归档 | | templates/ | 常用文档模板 | ## Inbox 处理流程 1. 扫描 inbox/ 中的新文件 2. 识别文件类型和任务意图 3. 在 tasks/ 下创建任务文件夹 {YYYY-MM-DD}-{任务名}/ 4. 将源文件从 inbox/ 移入任务文件夹 5. 路由到对应 skill 处理，产出物保存在同一任务文件夹 6. 更新 changelog.md、daily/{YYYY-MM-DD}.md、相关目录的 README.md ### 便签系统用户将文件放入 inbox 后，在对话中说明处理意图。Claude 据此生成便签，记录任务需求和处理方案。便签命名：task-{任务名}.md。多个任务的便签在 inbox 中共存，互不覆盖。任务处理完成后，便签随源文件一起移入任务文件夹，作为任务记录保留。 ### 文件路由 | 文件特征 | Skill | |---------|-------| | .xlsx / .csv / .tsv（数据分析、报表） | minimax-xlsx | | .docx（编辑、排版、套模板） | minimax-docx | | .pdf → Markdown 转换 | mineru | | .pdf（合并、拆分、提取、表单填写） | pdf | | 需要高品质设计的 PDF 输出 | minimax-pdf | | .pptx 或 PPT 相关需求 | pptx-generator | | 写日报 / 写周报 | work-report | | 长文档协作撰写 | doc-coauthoring | 多个 PDF skill 的选择：处理现有 PDF（合并、拆分、提取）→ pdf；将 PDF 转为 Markdown → mineru；生成高品质设计 PDF → minimax-pdf。路由歧义时询问用户，不自行猜测。 ## 索引体系三层索引，各有分工： | 索引 | 位置 | 粒度 | 内容 | |------|------|------|------| | changelog.md | 根目录 | 任务级 | 时间、任务名、源文件、产出物、skill、备注 | | daily/{date}.md | daily/ | 日+文件级 | 当日处理的所有文件清单 | | README.md | 各目录内 | 目录级 | 该目录下所有条目的摘要索引 | ## Loop 工作流 | Loop | 间隔 | 提示词 | 职责 | |------|------|--------|------| | inbox-monitor | 半小时 | .claude/loops/inbox-monitor.md | 扫描 inbox，处理新文件 | | daily-routine | 24 小时 | .claude/loops/daily-routine.md | 生成日报（含复盘），周五加周报 | ## 命名约定 - 任务文件夹：{YYYY-MM-DD}-{任务名}/（任务名用中文，简洁描述） - 报告：{YYYY-MM-DD}-日报.md、{YYYY-MM-DD}-周报.md - 产出物文件名应体现内容，不用通用名如 output.xlsx ``` 这份 `CLAUDE.md` 的设计有几个要点。文件路由表是核心——它把文件类型和 Skill 的对应关系写死，减少了 AI 猜测的空间。任务日志体系保证每个任务都有据可查：`changelog.md` 记录全局时间线，`daily/` 按天聚合当日处理的所有文件，各目录的 `README.md` 提供局部导航。便签系统是人机交互的桥梁——用户说意图，AI 生成一张任务卡片（便签），Loop 按卡片上的内容执行。 ### 规则一：inbox-interaction 便签是系统中的任务卡片。当用户把文件放进 `inbox/` 并说明处理意图后，AI 会生成一个 Markdown 文件（如 `task-销售分析.md`），里面记录要处理哪些文件、用户的具体需求、应该调用哪个 Skill。后续 Loop 轮询时，就是通过读取这些便签来了解该做什么。这条规则约束便签的生成过程。核心要求是必须通过 AskUserQuestion 工具确认用户意图，不能自行猜测。 ```txt # 便签生成规则当用户提到 inbox 中有新文件需要处理时，通过 AskUserQuestion 工具确认意图并生成便签。 ## 流程 1. 扫描 inbox/，列出新文件（文件名、类型、大小） 2. 使用 AskUserQuestion 工具向用户提问，收集处理意图和关键细节（如输出格式、语言、风格、篇幅等） 3. 根据用户回答生成便签 inbox/task-{任务名}.md ## 约束 1. 必须使用 AskUserQuestion 工具交互，不要直接假设用户意图 2. 一张便签对应一个任务。多批不相关文件分别生成便签，命名各自独立 3. 便签中必须明确：涉及的文件、用户需求、选定的 skill、处理步骤 4. 生成便签后，询问用户是否立即处理。用户确认后才执行，否则留给 inbox-monitor loop 轮询处理。不得自行决定立即处理 5. inbox-monitor loop 每次扫描时，检查 task-*.md 文件识别待处理任务 ``` ::: {.callout-tip} ## 便签支持异步批量处理用户可以一次投递多个文件、生成多张便签，然后离开。Loop 每半小时轮询一次，按便签内容逐个处理。便签处理完后随源文件一起移入任务文件夹，既是执行指令，也是任务记录。 ::: ### 规则二：task-changelog 每完成一个任务，系统需要在三个地方留下记录：`changelog.md`（全局任务日志，记录所有任务的时间线）、`daily/` 目录下的当日文件索引（汇总今天处理了哪些文件）、以及相关目录的 `README.md`（该目录下有什么内容）。这条规则确保这三处记录同步更新，不会遗漏。 ```txt # 任务日志规则每次完成一个任务（无论是 inbox 自动处理还是手动任务），必须同步更新三处索引。 ## 1. changelog.md（根目录）在表格顶部追加一行（最新的在最上面）： | 时间 | 任务 | 源文件 | 产出物 | Skill | 备注 | |------|------|--------|--------|-------|------| 字段要求： 1. 时间精确到分钟：YYYY-MM-DD HH:MM 2. 源文件记录原始文件名 3. 产出物记录相对路径（如 tasks/2026-04-16-销售分析/report.pdf） 4. 任务失败或部分完成也要记录，备注标注"失败"或"部分完成"及原因 ## 2. daily/{YYYY-MM-DD}.md 如果当日索引文件不存在，按模板创建，然后追加当前任务涉及的所有文件（源文件和产出物各一行）。 ## 3. 相关目录的 README.md 更新 tasks/README.md（新增任务条目）。如果产出物写入了其他目录（如 reports/），同步更新该目录的 README.md。 ``` ### 规则三：daily-review 这条规则要求日报末尾追加复盘章节。复盘基于 `changelog.md` 的事实记录，回答三个问题。 ```txt # 日报复盘规则生成日报时，在标准日报内容之后，必须追加"今日复盘"章节。 ## 复盘内容基于当天 changelog.md 中的实际处理记录，回答三个问题： 1. 效率回顾：今天的任务处理是否顺利？有没有路由错误、处理失败或反复修改的情况？ 2. 经验沉淀：发现了什么值得记住的模式、技巧或注意事项？ 3. 改进建议：流程、模板、skill 有没有需要优化的地方？ ## 约束 1. 复盘必须基于事实（changelog 记录），不凭空编造 2. 如果发现可复用的经验，建议保存到 memory 3. 如果发现 skill 或规则需要调整，主动提醒用户 4. 当天无任务处理时，复盘章节写"今日无任务处理" ``` 三条规则各管一段：inbox-interaction 管入口——怎么确认用户意图、生成任务卡片；task-changelog 管记录——任务完成后往哪几个地方写日志；daily-review 管复盘——日报末尾回顾当天的效率和经验。