CZON

AI分析报告生成基础规则

提示工程

👤 AI开发人员、文档分析师、自动化报告生成工具的用户,需要处理大量Markdown文件并生成结构化报告的人员。
本文档为AI分析报告生成的基础规则,核心内容包括文档阅读流程(分阶段获取文件列表、分批阅读与摘要、上下文管理、完整性验证和报告生成)、通用规则(如事实依据原则、引用链接规范、头部格式和时间权重)以及禁止行为。文档强调必须严格遵循流程,逐一阅读所有文件,基于事实生成报告,并提供了具体的操作指南和示例,旨在确保报告的系统性、准确性和完整性。
  • ✨ 必须逐一阅读所有Markdown文件,不得跳过任何文件
  • ✨ 采用渐进式阅读与摘要策略,分批处理文件并管理上下文
  • ✨ 报告生成需分段写入,确保内容控制在2000字以内并遵循格式规范
  • ✨ 所有观点必须有原文支撑,禁止虚构内容
  • ✨ 引用链接需使用相对路径并链接到具体文件,链接文本为标题
1,112 字 · 约 4 分钟阅读
  • AI分析报告
  • 文档处理
  • Markdown
  • 规则指南
  • 自动化流程
  • 摘要生成
  • 报告生成

AI 分析报告生成 - 基础规则

文档阅读流程(必须严格遵循)

核心原则

本仓库可能包含成百上千个 Markdown 文件。你必须逐一阅读每个文件,不得跳过。 为了处理大量文件,采用渐进式阅读与摘要策略。

阶段 1:获取完整文件列表

  1. 执行 npx czon@latest ls-files 获取所有 Markdown 文件
  2. 记录文件总数 N
  3. 将文件列表保存为待阅读队列

阶段 2:分批阅读与摘要

将文件分批处理。建议每批 10-20 个文件,但你可以根据文件大小和复杂度自行调整。

对于每一批:

  1. 阅读:使用 Read 工具逐一读取该批次的每个文件完整内容
  2. 提取:根据当前风格的关注点(见下方风格指南),提取相关信息
  3. 批次摘要:将该批次的提取信息整理为结构化摘要
  4. 累积:将批次摘要合并到「知识库」中(知识库结构见下方风格指南)

阶段 3:上下文管理

当上下文接近限制时:

  1. 压缩知识库:根据当前风格的压缩策略(见下方风格指南)压缩知识库
  2. 保留索引:无论如何压缩,必须保留所有文件的路径和标题索引
  3. 继续阅读:使用压缩后的知识库继续处理剩余文件

阶段 4:完整性验证

在生成报告前,必须确认:

  1. 文件列表中的所有 N 个文件都已处理
  2. 知识库包含每个文件的基本信息(至少有路径和标题)

如果发现遗漏:返回阶段 2 处理遗漏的文件。

阶段 5:生成报告(分段写入)

只有在完成以上所有阶段后,才能开始生成报告。

由于报告内容可能很长,必须分段写入,禁止一次性写入整个报告。

步骤 1:写入骨架文件

首先,使用 Write 工具创建报告文件,写入以下内容:

  • 头部格式(标题、AI 分析时间、文件数量、注释、分隔线)
  • 所有章节的标题(仅标题,不含正文)
  • 每个章节标题下方放置占位标记:<!-- SECTION: [章节名] -->

示例骨架

# 报告标题

**AI 分析时间**:2025年01月01日
**基于 42 个 Markdown 文件生成**
**注**:本报告由 AI 生成,内容仅供参考。

---

## 概述

<!-- SECTION: 概述 -->

## 第二章标题

<!-- SECTION: 第二章标题 -->

...

步骤 2:逐章节填充内容

按章节顺序,使用 Edit 工具逐一替换占位标记为实际内容:

  1. 每次只填充一个章节的内容
  2. <!-- SECTION: [章节名] --> 替换为该章节的完整正文
  3. 单次写入内容控制在 2000 字以内。如果某个章节超过 2000 字,将其拆分为多次写入(先写入前半部分并在末尾保留一个临时占位标记,再继续写入后半部分)

步骤 3:完整性检查

所有章节填充完毕后:

  1. 读取完整文件,确认无遗漏的 <!-- SECTION: 占位标记
  2. 确认所有链接格式正确(相对路径以 ../ 开头,链接文本为文章标题)
  3. 确认头部的文件数量 N 正确

禁止行为

  • ❌ 不得在阅读完所有文件前开始生成报告
  • ❌ 不得跳过任何文件,无论文件数量多少
  • ❌ 不得仅阅读部分文件就声称"已了解全貌"
  • ❌ 不得在知识库中虚构不存在的文件或内容

通用规则

1. 事实依据原则

  • 切记以事实内容为依据,不得出现脱离事实的情况
  • 所有观点必须有原文支撑
  • 不得虚构不存在的内容

2. 引用链接规范

  • 引用原文链接时,保证链接有效
  • 永远链接到具体的 Markdown 文件,不要链接目录
  • 链接文本应当是对应的标题,而不是文件名
  • 由于生成到 .czon/AIGC/SUMMARY/ 目录,引用时使用 ../../../ 开头的相对路径

正确示例

[资本持久战:个人投资者跨越阶级的战略](../../../INSIGHTS/6.md)
[从创作到分发——构建AI-Native内容引擎](../../../INSIGHTS/4.md)

错误示例

[INSIGHTS/6.md](../../../INSIGHTS/6.md) ← 使用了文件名而非标题
[资本持久战](../../../INSIGHTS/) ← 链接到了目录

3. 头部格式

每个报告必须以以下格式开头:

# [报告标题]

**AI 分析时间**:YYYY年MM月DD日
**基于 N 个 Markdown 文件生成**
**注**:本报告由 AI 生成,内容仅供参考。

---

其中 N 为阶段 1 中获取到的实际 Markdown 文件总数。

4. 时间权重

  • 考虑时间跨度,给予最近的文章更高的权重
  • 但不要忽略较早的重要内容

See Also