文件边界管理技能Skill file-boundaries

文件边界管理技能是一种用于软件开发团队并行协作的规范模式。其核心功能是定义和强制执行代码文件的所有权边界,以防止并行开发中的文件冲突和代码覆盖。关键词包括:并行开发、文件所有权、代码冲突预防、团队协作规范、软件开发流程、版本控制辅助、代理协作、边界管理。该技能通过明确的“拥有”和“可读”列表,确保开发人员或AI代理只在授权范围内操作,提升开发效率与代码库稳定性。

DevOps 0 次安装 0 次浏览 更新于 3/2/2026

name: 文件边界管理 描述: 在并行开发中尊重文件所有权边界的模式。防止并行工作时的冲突。 允许工具: 读取, 写入, 编辑

文件边界管理技能

在并行工作中尊重文件所有权的模式。

何时加载此技能

  • 您正在有明确边界的范围内实现代码
  • 您正在与其他代理并行工作
  • 您需要避免文件冲突

边界规则

您拥有的文件

边界:
  拥有: [src/auth/login.ts, src/auth/logout.ts]

您可以:

  • 读取这些文件
  • 修改这些文件
  • 在这些路径中创建新文件
  • 删除这些文件

您可读取的文件

边界:
  可读: [src/types/user.ts, src/utils/crypto.ts]

您可以:

  • 为参考而读取这些文件
  • 从这些文件中导入

您不可以:

  • 修改这些文件
  • 如果需要更改 → 报告为“受阻”

检查边界

在修改任何文件之前:

  1. 此文件是否在我的拥有列表中?
  2. 如果否 → 停止,不要修改
  3. 如果需要修改 → 报告为“受阻”并提供详细信息

报告边界违规

如果您需要修改边界之外的文件:

状态: 受阻
受阻原因: 边界违规
受阻详情:
  描述: "需要修改 src/types/user.ts 以添加新类型"
  需求: "修改权限或合同更新"
  建议解决方案: "将 UserSession 类型添加到 user.ts"

并行工作安全

边界的存在是为了实现并行工作:

  • 代理 A 拥有 src/auth/
  • 代理 B 拥有 src/api/
  • 两者可以同时工作而不会发生冲突

如果边界不明确或需要更改:

  • 停止并报告为“受阻”
  • 不要假设或继续

原则

  • 严格所有权 - 只接触您拥有的内容
  • 明确边界 - 没有隐含权限
  • 阻止,而非绕过 - 报告问题,不要试图规避