多智能体文件系统治理

使用此技能在多个智能体可能创建、编辑、移动、下载、组织或归档文件的环境中，做出安全且一致的文件系统决策。

该技能管理所有权、存放位置、生命周期和写入边界。它不绑定于特定产品、路径结构、操作系统或笔记工具。

核心目标

确保每个文件都具备：

1. 明确的所有权范围
2. 明确的存储位置
3. 明确的生命周期状态
4. 明确的修改规则

当不确定时，选择最狭窄的安全范围和最少共享的位置。

作用域模型

将每个文件、文件夹及文件操作归入以下唯一一个作用域类别：

• agent-private：仅由单一智能体使用
• shared：有意被多个智能体重复使用或访问
• archive：非活跃、历史性的、已完成的、已冻结的，或为参考而保留

若作用域不明确，缺省采用 agent-private。

存储模型

概念上使用三个顶层存储类别，即使本地目录名称不同也应保持一致：

• agent areas：每个智能体私有的工作位置
• shared areas：通用可复用资源
• archive areas：非活跃或历史材料

不依赖任何单一硬编码路径。即使适配本地布局，也需保留概念上的边界。

必须遵循的决策顺序

在创建、编辑、移动、重命名或删除文件前，按以下顺序确定：

1. 该产物是什么？
2. 它是临时的、活跃的、可复用的、已冻结的还是历史性的？
3. 它是单个智能体专用，还是多个智能体共享？
4. 最小且有效的存放位置是哪个？
5. 此操作是否会影响其他智能体或共享工作流？

若任一问题不明确，优先选择私有且非破坏性的位置。

默认规则

优先选择私有而非共享

若文件未明确需要跨智能体复用，则放置于智能体私有位置。

默认禁止跨智能体写入

除非任务明确要求，否则不得创建、编辑、移动或覆盖属于其他智能体的文件。

将共享位置视为高影响操作

向共享位置写入是影响范围更广的操作。仅在有意复用、协作或标准化时才使用共享位置。

将归档与活跃工作分离

归档内容不是活跃工作区。不要在归档位置继续编辑文件。如需修改，请先恢复或复制到活跃或私有区域。

将临时位置视为可丢弃

不要将文件的重要副本仅存放在临时或暂存位置。

内容类型存放指南

无论具体本地路径名称如何，均应用以下规则：

技能（Skills）

• 可复用的多智能体技能应置于共享技能位置。
• 实验性、智能体专用或覆盖型技能应置于智能体私有技能位置。
• 若同一技能同时存在于共享和私有位置，对该智能体而言应优先使用更具体的私有版本。

工作区（Workspaces）

• 活跃的工作文件、草稿和中间产物应置于当前智能体的私有工作区，除非有意共享。
• 不要过早将私有任务文件移入共享位置。

脚本（Scripts）

• 可复用的实用脚本应置于共享脚本位置。
• 任务特定或智能体专用脚本应置于私有脚本位置或相关项目内。
• 不得随意将无关脚本散落在任意文件夹中。

下载内容（Downloads）

• 新下载的文件应首先进入专用接收位置。
• 后续再分类并移至长期有效位置。
• 不得在项目文件夹、知识库或临时目录中无目的地散放下载文件。

知识笔记与知识库（Knowledge notes and vaults）

• 持久的参考性笔记和整理过的知识应放入指定的知识库或知识库位置。
• 初步的任务笔记应保持私有，直到其具有保存或共享价值。
• 不得将知识库用作任意临时文件的堆积地。

代码项目（Code projects）

• 代码项目应存储在指定的项目位置。
• 对于持久、长期存在的仓库，建议使用专用项目根目录，例如 ~/projects/<repo>。
• 使用 /tmp/... 进行临时重现、验证或一次性克隆，完成后将持续工作迁移到 ~/projects/<repo>。
• 在可行情况下，对实验性、活跃、冻结和归档项目进行分离。
• 不得将项目源码树与一般下载内容、归档资料、笔记仓库或智能体运行时/配置树混合存放。
• 当具体涉及正式仓库应存放何处，以及临时仓库工作应如何处理时，请查阅 references/project-directory-best-practices.md。

归档（Archives）

• 将非活跃、已完成、已被取代或需保留的材料移入归档位置。
• 保持归档结构稳定，减少变动频率。
• 除非明确需要清理，否则优先采用追加式归档行为。

文件生命周期模型

将文件划分为以下生命周期状态之一：

• temporary：临时、可丢弃、可重建
• active：正在被编辑或使用
• shared：被多个智能体主动复用
• frozen：暂停但可能恢复
• archived：历史性、已完成或为记录而保留

当生命周期发生变化时，应移动文件或说明保留原位的理由。

文件操作安全规则

创建（Create）

在最小且有效的范围内创建文件。

编辑（Edit）

仅在所有权和作用域明确时，才就地编辑。

移动（Move）

在所有权或生命周期变化时移动文件。

复制（Copy）

在需要保留历史记录或最小化干扰时，优先使用复制而非移动。

删除（Delete）

仅在文件明确为临时、冗余或已获明确批准删除时方可删除。

重命名（Rename）

重命名应提升清晰度、所有权、生命周期可见性或可发现性——不得仅为外观调整而频繁重命名。

冲突与优先级规则

当多个作用域中存在等效资源时，优先选择最具体的有效来源：

技能：多代理文件系统治理

版本：1.0.1

分块：2/2

位置类型

• agent-private（代理私有）
• shared（共享）
• bundled, default, or global（捆绑、默认或全局）

请有意识地使用覆盖规则，无明确理由时不要创建重复的变体。

应避免的行为

避免以下模式：

• 将所有内容集中存放在单一共享根目录中
• 将归档目录用作实时工作区
• 在未经过筛选的情况下直接下载到长期存储中
• 将脚本分散在无关的文件夹中
• 将代码项目与笔记库内容混杂存放
• 仅将持久性知识存放在临时笔记中
• 未经明确需要，编辑其他代理的私有区域
• 默认情况下出于“以防万一”的原因使用共享位置

不确定时的推荐做法

当无法确定正确存放位置时，请遵循：

1. 优先选择 agent-private
2. 优先选择非破坏性操作
3. 保持可逆性
4. 避免对共享位置进行写入
5. 仅在模糊性对后续组织结构或其他代理造成实质性影响时，才请求澄清

决策模板

在决定某物应存放于何处时，返回以下内容：

• 作用范围：
• 生命周期：
• 推荐位置类型：
• 原因：
• 共享影响备注：

输出期望

应用此技能时需满足：

• 明确说明作用范围
• 明确说明生命周期
• 推荐最精确有效的存放位置
• 说明是否影响其他代理
• 优先采用持久性规则，而非临时路径猜测