knowledge-and-files

name	knowledge-and-files
description	个人知识与文件整理中枢。

个人知识与文件整理 (Knowledge and Files)

模块定位

本模块是所有涉及本地工作区（Workspace）文件操作与知识处理的顶层入口，对外部路径仅可以进行只读操作。当任务目标是读取本地笔记、分析已有数据文件、整理归档杂乱文档或生成新的结构化文件时，应进入此模块。

任务路由与子 Skill 分发

在处理文件与知识任务前，请根据目标数据类型和处理深度进行路由：

1. 基础读写与简单编辑：对于简单的纯文本（.txt, .md, .json, .csv）的小规模读取或修改，无需下发子任务，直接在当前层级调用系统的底层基础工具（如 read_file, write_file, edit_file, list_dir）完成。
2. 复杂格式解析与数据分析：当遇到多页 PDF 提取、大型 Excel 跨表计算、Word 复杂排版读取或图像文档 OCR 时，必须调用专门处理该格式的子 Skill。
3. 海量知识检索：若任务需要“从我过去半年的笔记中总结某个话题”，且文件数量庞大无法单次读取，应下发给具备检索能力的子 Skill。

默认文件基础操作能力

若在当前层级自行处理，请遵循底层工具的调用规范：

• 目录探索 (list_dir)：处理未知目录前，务必先列出目录结构，了解文件真实分布，禁止凭空猜测文件名。
• 精准修改 (edit_file)：进行局部修改时，必须确保 old_text 的参数与原文件内容 100% 匹配。
• 全量写入 (write_file)：如果文件不存在或需要完全重写，使用此工具。注意，这会覆盖原有内容。

执行纪律

1. 禁止盲目覆写：在修改任何重要文件前，必须先使用 read_file 读取当前内容，理解上下文后才能调用修改/写入工具。严禁在未读取的情况下直接清空或覆盖用户数据。
2. 幻觉防御：总结或提取文件内容时，必须严格基于工具返回的文本。如果文件中不存在任务所要求的信息，必须如实汇报“文件中未提及”，绝对禁止基于文件标题自行脑补内容。
3. 操作原子性：如果任务包含“读取 A -> 分析 -> 生成 B”，必须确保 A 的读取真实成功，再去生成 B。若中途工具报错（如路径错误、编码错误），立刻停止生成并向 Solver 报告。
4. 交付物规范：若任务的最终目的是生成一个实体文件，在内容准备完毕并写入本地后，必须调用 report_deliverable_file 工具向上游提交物理路径。