maintain-agentic-system

维护 Agentic System

使用此技能升级、演进或审计现有的仓库本地 Agentic System。

使命

在推进生成的系统时，不丢失仓库有意做出的改动。每项提议都要以 Bootstrap 编写的维护基线为基础进行三方合并，因此升级绝不会意外覆盖自定义内容，自定义内容也绝不会悄无声息地阻碍升级。

不可妥协的原则

• 仅维护 Agent System 文件。绝不触碰应用代码、架构、迁移文件、运行时配置或产品测试。
• 绝不读取、枚举或修改会话文件夹的内容。会话根目录是一个已配置的路径，不是证据来源。
• 先制定维护计划，并在编辑文件前等待明确批准。默认不予批准。
• 按区域与基线比较。仅上游有改动的区域采用上游版本；仅仓库有改动的区域予以保留；双方均有改动的区域需要确认。
• 绝不能仅凭变更日志文本就断定 Bootstrap 的改动缺失。先检查仓库文件。
• 不要复述生成系统检查清单。该清单位于同级 Bootstrap 技能的审计约定中；指出未通过的检查项即可。
• 仅在用户批准更改后刷新基线、答案文件和自定义登记表，绝不能提前刷新。
• 根据同级 Bootstrap 兼容性约定评估平台变更。除已声明的替换项外，保持规范副本完整；将旧版差异保留为明确的冲突，绝不能悄然认定其符合要求。

约定文件

此文件用于路由。只加载当前关卡所需的约定；不要一开始就全部加载。

约定	加载时机
contracts/modes-and-scope.md	关卡 0-2：模式选择、范围边界、系统检测、子 Agent 委派。
contracts/merge-model.md	关卡 3-5：三方合并、区域、冲突、自定义登记表、基线刷新。
contracts/delta-audit.md	关卡 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。

维护关卡

按顺序运行各关卡。每项都说明关卡的用途和适用的约定。

• 关卡 0，范围接收：确认这是 Agent 系统维护，并确定模式。参见 contracts/modes-and-scope.md。
• 关卡 1，系统检测：找到现有系统，并记录维护基线中已存在的部分。参见 contracts/modes-and-scope.md。
• 关卡 2，证据扫描：阅读 Agent 系统文件、影响这些文件的仓库变更，以及版本来源信息。参见 contracts/modes-and-scope.md。
• 关卡 3，差异收集：从已安装的变更日志、模板、注册表、快照和仓库证据中收集并分类每一项 Bootstrap 约定差异。参见 contracts/delta-audit.md。
• 关卡 4，区域合并：按区域执行三方合并，与用户解决冲突，并应用登记规则。参见 contracts/merge-model.md。
• 关卡 5，维护计划与获批应用：制定计划、获得批准、仅写入获批操作，然后刷新基线和来源信息。参见 contracts/delta-audit.md 和 contracts/merge-model.md。
• 关卡 6，最终验证：验证操作、合并决策、刷新的基线以及生成系统检查。参见 contracts/delta-audit.md。

在 audit 模式下，于关卡 4 后停止并报告。不要写入任何内容。

输出格式

写入前：输出模式、已分类的差异列表、各区域的合并结果、拟议操作和未经批准的计划，然后请求明确批准。

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