AI 分析报告生成 - 基础规则
文档阅读流程(必须严格遵循)
核心原则
本仓库可能包含成百上千个 Markdown 文件。你必须逐一阅读每个文件,不得跳过。 为了处理大量文件,采用渐进式阅读与摘要策略。
阶段 1:获取完整文件列表
- 执行
npx czon@latest ls-files获取所有 Markdown 文件 - 记录文件总数 N
- 将文件列表保存为待阅读队列
阶段 2:分批阅读与摘要
将文件分批处理。建议每批 10-20 个文件,但你可以根据文件大小和复杂度自行调整。
对于每一批:
- 阅读:使用 Read 工具逐一读取该批次的每个文件完整内容
- 提取:根据当前风格的关注点(见下方风格指南),提取相关信息
- 批次摘要:将该批次的提取信息整理为结构化摘要
- 累积:将批次摘要合并到「知识库」中(知识库结构见下方风格指南)
阶段 3:上下文管理
当上下文接近限制时:
- 压缩知识库:根据当前风格的压缩策略(见下方风格指南)压缩知识库
- 保留索引:无论如何压缩,必须保留所有文件的路径和标题索引
- 继续阅读:使用压缩后的知识库继续处理剩余文件
阶段 4:完整性验证
在生成报告前,必须确认:
- 文件列表中的所有 N 个文件都已处理
- 知识库包含每个文件的基本信息(至少有路径和标题)
如果发现遗漏:返回阶段 2 处理遗漏的文件。
阶段 5:生成报告(分段写入)
只有在完成以上所有阶段后,才能开始生成报告。
由于报告内容可能很长,必须分段写入,禁止一次性写入整个报告。
步骤 1:写入骨架文件
首先,使用 Write 工具创建报告文件,写入以下内容:
- 头部格式(标题、AI 分析时间、文件数量、注释、分隔线)
- 所有章节的标题(仅标题,不含正文)
- 每个章节标题下方放置占位标记:
<!-- SECTION: [章节名] -->
示例骨架:
# 报告标题
**AI 分析时间**:2025年01月01日
**基于 42 个 Markdown 文件生成**
**注**:本报告由 AI 生成,内容仅供参考。
---
## 概述
<!-- SECTION: 概述 -->
## 第二章标题
<!-- SECTION: 第二章标题 -->
...
步骤 2:逐章节填充内容
按章节顺序,使用 Edit 工具逐一替换占位标记为实际内容:
- 每次只填充一个章节的内容
- 将
<!-- SECTION: [章节名] -->替换为该章节的完整正文 - 单次写入内容控制在 2000 字以内。如果某个章节超过 2000 字,将其拆分为多次写入(先写入前半部分并在末尾保留一个临时占位标记,再继续写入后半部分)
步骤 3:完整性检查
所有章节填充完毕后:
- 读取完整文件,确认无遗漏的
<!-- SECTION:占位标记 - 确认所有链接格式正确(相对路径以
../开头,链接文本为文章标题) - 确认头部的文件数量 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. 时间权重
- 考虑时间跨度,给予最近的文章更高的权重
- 但不要忽略较早的重要内容