record-file

# 文件记录 Skill ## 概述 作为 AI 伴侣，你在 companion 目录下创建或修改文件时，必须在 AGENTS.md 中留下记录。这就像你对自己"做了什么"的记忆——以后你能知道自己创建过哪些文件、为什么创建它们。 ## 何时触发 - 使用 `write_file` 创建新文件后 → 立即追加记录 - 使用 `edit_file` 修改现有文件后 → 更新对应记录（如有实质变化） - 使用 `write_file` 完全覆盖已有文件 → 更新对应记录 **不需要记录的情况**： - 只是读取文件（`read_file`、`ls`、`glob`、`grep`） - 修改内容微不足道（修正拼写、格式化），可跳过 ## 记录格式 在 AGENTS.md 的 `# 文件记录` 章节下，每条记录占一行： ``` - [文件名](相对路径) — 用途说明（创建时间：YYYY-MM-DD） ``` 示例： ``` - [SKILL.md](skills/user/my-skill/SKILL.md) — 用户自定义技能，用于快速搜索本地文档（创建时间：2026-06-25） - [notes.txt](notes.txt) — 用户口述的购物清单（创建时间：2026-06-25） ``` ## 操作流程 ### 创建新文件 1. 执行 `write_file` 创建文件 2. 读取 AGENTS.md 当前内容（如不确定文件记录章节位置） 3. 使用 `edit_file` 在 `# 文件记录` 章节末尾追加一条记录 4. 记录包含：文件名（带相对路径）、用途简述、创建日期 ### 修改已有文件 1. 执行 `edit_file` 修改文件 2. 如果修改改变了文件的用途或内容性质，更新 AGENTS.md 中对应记录 3. 如果只是小修补（改个错字、微调格式），不需要更新记录 ### 如果 AGENTS.md 没有"文件记录"章节 在文件末尾新建该章节： ``` # 文件记录 - [xxx](xxx) — xxx（创建时间：YYYY-MM-DD） ``` ## 关键规则 1. **必须记录**：创建任何新文件后，必须在同一轮对话中更新 AGENTS.md 2. **简洁**：每条记录一行，用途说明不超过 20 字 3. **准确**：文件路径必须是相对 companion 目录的路径 4. **去重**：同一文件不重复记录——如果已存在该文件的记录，更新它而不是新增一行 5. **不过期**：文件被删除后，不要自动删除记录（你可能不记得删过什么，留作参考） 6. **不越界**：只能记录 companion 目录内的文件