SuperAPI AI 工具集

maintain-agentic-system

智能体与模型

查看项目

更新于 10-16 02:44

技能介绍

用途

Maintain Agentic System 用于升级、演进或审计一个已存在的仓库本地 Agentic System。它的目标是在不丢失仓库有意做出的自定义的前提下,将生成的系统向前推进。

主要能力

  • 三方合并:每个提案都针对 Bootstrap 写入的维护基线进行三方合并,因此升级不会意外覆盖自定义,自定义也不会静默阻止升级。
  • 按区域比较:仅上游变更的区域采用上游;仅仓库变更的区域保留仓库版本;双方都变更的区域作为待确认问题。
  • 增量审计:从已安装的 changelog、模板、注册表、快照和仓库证据中收集并分类每个 Bootstrap 契约增量。
  • 平台兼容性评估:使用同级 Bootstrap 兼容契约评估平台变更,在声明的替换之外保持规范副本完整,将遗留偏差保留为可见冲突。
  • 审计模式:只读报告,不写入任何内容。

使用方式

该技能按 Gate 顺序执行:

  • Gate 0,范围接收:确认这是 agent-system 维护并确定模式。
  • Gate 1,系统检测:找到现有系统并记录维护基线的哪些部分存在。
  • Gate 2,证据扫描:读取 agent-system 文件、影响它们的仓库变更以及版本来源。
  • Gate 3,增量收集:收集并分类每个 Bootstrap 契约增量。
  • Gate 4,区域合并:按区域运行三方合并,与用户解决冲突,应用注册表规则。
  • Gate 5,维护计划与批准应用:产出计划,获得批准,仅写入已批准的操作,然后刷新基线和来源。
  • Gate 6,最终验证:验证操作、合并决策、刷新后的基线以及生成系统检查。

在审计模式下,在 Gate 4 后停止并报告,不写入任何内容。

该技能是一个路由器,按当前所处的 Gate 加载对应契约,而不是一次性全部加载:

  • contracts/modes-and-scope.md:Gate 0-2,模式选择、范围边界、系统检测、子代理委派。
  • contracts/merge-model.md:Gate 3-5,三方合并、区域、冲突、自定义注册表、基线刷新。
  • contracts/delta-audit.md:Gate 3-6,增量收集与分类、计划形态、最终验证。

对于布局隔离、维护入口点和旧混合系统的迁移,加载同级 bootstrap-agentic-system/contracts/context-boundaries.md。对于环境选择、当前文档研究、原生适配器、保留检查和版本 1 答案迁移,加载同级 bootstrap-agentic-system/contracts/platform-compatibility.md。生成系统契约本身不在此重复,需要了解完整生成系统要求时加载同级 bootstrap-agentic-system/contracts/audit-and-handoff.md。

不可协商原则

  • 仅维护 agent-system 文件。绝不触碰应用代码、schema、迁移、运行时配置或产品测试。
  • 绝不读取、枚举或修改 session 文件夹内容。session 根是配置路径,不是证据来源。
  • 产出维护计划并等待明确批准后再编辑文件。批准默认为否。
  • 按区域与基线比较。
  • 绝不单凭 changelog 文本声明 Bootstrap 增量缺失,先检查仓库文件。
  • 不重述生成系统检查清单,它位于同级 Bootstrap 技能的审计契约中;引用失败的检查。
  • 仅在用户批准变更后刷新基线、答案文件和自定义注册表,绝不提前。

输出形态

写入前:输出模式、分类后的增量列表、按区域的合并结果、拟议操作和未批准的计划,然后请求明确批准。

写入后:输出已更改文件、冲突解决、验证结果、新的已应用版本、刷新后的基线和答案路径、新增的注册表行、维护后建议以及剩余风险。

适用场景

  • 将仓库本地 Agentic System 升级到更新的 Bootstrap 契约。
  • 随仓库变化演进 Agentic System。
  • 审计 Agentic System 的当前状态。

限制

  • 不触碰应用代码、schema、迁移、运行时配置或产品测试。
  • 不读取、枚举或修改 session 文件夹内容。
  • 编辑前必须获得明确批准,批准默认为否。
  • 审计模式下不写入任何内容。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。