archive

archive 技能概览

archive 技能的作用是什么

archive 技能是一个面向 OrbitOS 风格 vault 的 Document Filing 专用工作流。它的职责很明确：找出已完成的项目和已经处理过的 inbox 笔记，确认哪些内容可以安全移动，然后按日期归档到对应文件夹，同时不丢失可追溯性。如果你希望活跃目录更清爽，但又需要可靠的历史记录，这个 archive 技能就是为这种日常维护场景设计的。

谁适合安装 archive

如果你的工作区使用结构化 markdown 笔记、frontmatter 状态字段（如 status: done 或 status: processed），并且目录结构比较固定，比如 20_Project/、00_Inbox/ 和 99_System/Archives/，那么适合安装 archive。它更适合已经有明确归档规范、想把归档流程做成可重复操作的用户；如果你要找的是一个通用型知识管理助手，那它并不是最佳选择。

用户为什么会选择这个 archive 技能

archive 的核心差异点在于，它不只是“移动旧文件”。它会先识别归档候选项，区分项目和 inbox 内容，要求你确认归档范围，再把内容归入按年或按月组织的归档路径。相比一个泛泛的提示词，这种方式更稳妥，特别适合希望 agent 保留原有结构、并输出变更摘要的场景。

如何使用 archive 技能

安装前提与预期的 vault 结构

这个 archive 安装项更适合被理解为一个 repository 或 vault skill，而不是独立应用。现有仓库内容表明，该工作流默认预期以下结构：

• 20_Project/ 用于项目
• 00_Inbox/ 用于 inbox 条目
• 99_System/Archives/Projects/YYYY/
• 99_System/Archives/Inbox/YYYY/MM/

在使用 archive 之前，先确认你的笔记系统确实遵循这套布局；如果不一致，就在 prompt 里明确改写路径。优先阅读 SKILL.md，因为完整逻辑都在这个文件里；仓库中没有 helper scripts 或参考文件来解释额外的隐藏行为。

archive 需要什么输入，效果才会更好

archive 技能在你提供明确规则时效果最好，而不是只说一句“帮我整理笔记”。高质量输入通常包括：

• 你的 vault 根路径
• frontmatter 是否使用 status: done 和 status: processed
• 已处理的 inbox 笔记是否也可以通过 [[ProjectName]] 链接来识别
• 你希望归档全部候选项，还是只归档其中一部分
• 你要 agent 只预览移动方案，还是直接执行

更好的 prompt 示例：
“Use the archive skill on my vault. Scan 20_Project/ for notes with status: done and 00_Inbox/ for notes with status: processed or clear conversion links. Show candidates first, then archive only confirmed items into dated folders and provide a summary report.”

archive 的实用使用流程

一套比较稳妥的 archive usage 流程通常是：

1. 先让它只做发现，不执行移动。
2. 审核候选列表。
3. 批准全部、仅项目、仅 inbox，或指定条目。
4. 再让 agent 把文件移动到归档目录。
5. 最后要求输出报告，列出旧路径、新路径，以及所有边缘情况。

这个两步式流程很重要，因为该技能本身就是围绕“先确认、后移动”设计的。这样可以减少仍在活跃使用的笔记被误归档，也更方便你事后审计结果。

仓库阅读路径与质量建议

对于这份 archive 指南，最关键的文件是 EN/.agents/skills/archive/SKILL.md。建议先读其中的 “Identify Items to Archive” 和 “Archive Process” 两节，它们直接说明了实际的触发条件和目标归档结构。

一些能明显提升结果质量的建议：

• 在运行 archive 前先统一 frontmatter；如果状态字段不一致，识别准确率会明显下降。
• 如果缺少完成日期，提前告诉 agent 应该依据什么日期来做按年归档。
• 在请求中加入 “summary report + exceptions”，这样你更容易发现断链、缺失日期，或项目目录与单文件混杂等情况。
• 如果你的 vault 命名方式和 OrbitOS 不同，直接在 prompt 里写明你自己的等效路径。

archive 技能 FAQ

archive 比普通归档 prompt 更好吗？

如果你的笔记系统本来就比较稳定，那么答案是肯定的。普通 prompt 也许能建议你归档，但 archive skill 提供的是一套明确的决策流程：识别候选项、展示选择、按内容类型移动，并按日期组织归档目录。这能减少猜测成本，也更适合反复执行的日常维护。

archive 适合新手吗？

只有在你的 vault 已经具备一定结构化基础时，archive 才算对新手友好。如果你的笔记没有标签、状态不统一、目录组织也比较随意，那么在你先把输入标准化之前，这个技能的价值会比较有限。它不是一个能自动拯救混乱笔记库的“魔法清理工具”。

什么情况下不该使用 archive？

当条目仍在活跃使用、完成状态不明确，或者你需要的是跨 vault 迁移而不是简单归档时，都不建议使用 archive for Document Filing。如果你的系统也不是基于 markdown 文件和 frontmatter 状态来管理内容，它同样不太适合。

这份 archive 指南的主要边界是什么？

从仓库内容看，核心只有一个主文件，没有配套自动化脚本，因此这个技能的价值主要体现在 prompt 设计和工作流纪律上，而不是可直接执行的工具链。你可以期待它提供清晰的归档逻辑，但不要预期它天然具备深度校验、自动修复链接，或自定义迁移代码——除非你在自己的 agent 工作流里另外补上这些能力。

如何改进 archive 技能

为 archive 提供更明确的决策信号

想提升 archive 的结果，最快的方法就是先把源数据的元信息整理清楚。统一使用 status 值，补充完成日期，并在 inbox 笔记中明确项目链接。archive 技能正是依赖这些信号，来区分哪些内容可以安全归档，哪些仍属于活跃资料。

预防 archive 的常见失败模式

最常见的问题包括误判、日期缺失，以及项目文件夹和单个文件在目标位置上的歧义。为了减少错误，可以要求 agent：

• 在移动任何内容之前先预览候选项
• 标记元数据不完整的笔记
• 区分 “ready to archive” 和 “needs review”
• 在执行前报告任何路径冲突

为 archive 使用写出更强的 prompt

弱一些的请求是：“archive my vault.” 更强的写法是：
“Run the archive skill in preview mode. Detect completed projects in 20_Project/ and processed inbox notes in 00_Inbox/. Use frontmatter first, then project links as a secondary signal. Show proposed destination paths under 99_System/Archives/, highlight uncertain items, and wait for approval before moving files.”

这个 prompt 更有效，因为它明确了处理范围、识别顺序、执行模式和报告预期。

在第一次 archive 之后继续迭代

第一次运行后，回头看一看这个技能漏掉了什么、误判了什么。然后据此更新你的 prompt 或 vault 规则：补齐缺失的状态字段，定义无日期笔记应该如何处理，并说明已转换的 inbox 笔记是否应该一律归档。随着归档规则越来越明确、越来越可重复，archive install 的长期价值也会越来越高。