SuperAPI AI 工具集

maintain-skills

智能体与模型

查看项目

更新于 10-28 16:16

技能介绍

用途

maintain-skills 用于维护一个技能库,使其中的上游技能与各自上游保持同步,同时保留适合当前设置的轻量本地适配。它同时承担审计职责,检查库内技能是否与当前工具、文档和仓库约定一致。

主要能力

该技能支持两种运行模式:

  • Upstream 模式:采纳自每个技能上次审阅位置以来的上游变更,导入新的上游技能,并复查自上次运行以来文件发生变化的技能。
  • Audit 模式:先完成上游工作,然后处理遗留项、保真度积压、待处理技能和过期审阅,逐一对照当前工具、文档和仓库约定检查每个技能。

模式可由用户或计划任务指定;若未指定,则由 begin 选择。只有明确指定技能子集时,才会缩小任一模式的范围。

该技能全程使用 /swarm。每个工作者获得一个切片,例如一个来源组、一批技能或一项修复,并附带确切的本地修订、不可变候选、适配契约、证据要求以及可写入的文件。工作者直接完成自己的切片,不启动另一个协调者。协调者负责获取来源、持有检查点、维护规范文档与集成,并收集每个工作者的结果;失败或缺失的结果保持待处理状态。若不进行委派,则按顺序工作,并在运行报告中注明失去的独立性。

使用方式

流程分为五个阶段:

  1. 开始:读取仓库的 AGENTS.md、适配契约和维护指南,运行 begin。若报告锁被持有,则停止并指出持有锁的运行。否则本次运行持有锁,直到运行 release。记录 begin 的遗留项,按指南的分支规则同步两个工作树。读取自 commentsSince 以来在打开的维护 PR 及相关 PR 上的所有者评论。用 scripts/check-installs.py 检查已安装副本,并在过期时按 AGENTS.md 刷新。从库工作树用 begin 的检查点运行 inventory --resume。

  2. 查找变更:运行 fetch,然后用 --resume 运行 compare --fetch。将清单、fetch 结果和 compare 报告保存在运行文件夹中。按顺序构建工作清单:尚未应用的所有者答复和评论、已推送但无 PR 的维护分支;变更的上游技能和共享输入、获取失败的每个来源;目录套件中新增、移除或移动的上游技能;changedSince 中的技能(包括新技能)以及 contextChanged 中的输入;仅在 Audit 模式下,还包括遗留项(逾期优先)、清单的 fidelityBacklog、检查点列为待处理的技能,以及最旧的 staleReviews(最多占库的四分之一)。

  3. 决策与修复:按指南的分支规则在维护分支上编辑。按适配契约决定每个上游变更,并记录决策。使用 /writing-for-agents 将修复分派给隔离的写入者,并检查每个返回的差异。按契约导入新的上游技能并提出退役建议。当变更涉及共享所有者时,检查其在两个套件中的消费者。对 changedSince 中的每个技能,检查其编辑是否保留了记录的适配和仓库约定。对 contextChanged 中的每个输入,读取其自检查点的 libraryRevision 以来的差异,并列出其审阅受影响的每个技能。在 Audit 模式下,从暴露的工具模式、已安装版本和本地帮助输出开始,对照每个技能支持的环境检查工具名称、命令、链接和实践。

  4. 验证:端到端阅读变更的指令并运行维护指南的检查。在小型隔离示例上演练变更的脚本或工作流,并确认每个新的回归测试在撤销其修复后失败。对确切的差异、其决策、保真度和覆盖范围分派独立的终审,并解决其发现。重新枚举技能,使运行期间新增的内容进入覆盖范围。仅当技能的整个上游增量已决定且检查通过时,才推进其 reviewed-through 位置。

  5. 交付:将库变更和此技能自身流程的变更提交到各自的维护分支,按指南的推送规则推送每个分支,并在行动授权范围内为每个分支创建或更新一个草稿 PR。每个 PR 验证后,结算运行时状态:移除其提交完成或描述要求的遗留项,以及其提交记录答案的问题,然后保存检查点。清理旧运行,然后运行 release。报告变更内容、等待所有者的问题、失败(如失败的来源和丢弃的遗留项)以及仍待处理的覆盖范围。

适用场景

适用于需要持续维护技能库、使其上游技能保持最新并定期审计技能质量的场景。可由用户手动调用,也可由计划任务触发。

限制

资料中未提供关于收费、价格、平台支持范围或具体效果的信息。该技能依赖仓库中的 AGENTS.md、适配契约和维护指南等文件,以及 /swarm、/writing-for-agents 等工具。具体命令和脚本行为需参照仓库内文档。