SuperAPI AI 工具集

status

部署与运维

查看项目

更新于 10-15 19:57

技能介绍

用途:setup-status 是 apache-magpie 的配置视图技能,用于一眼看清当前仓库如何采用 Magpie,并在不离开视图的情况下让用户重新配置。它回答运维者关心的问题:安装方式与锁定版本、快照是否漂移、哪些 agent 目标已接线、安装了哪些技能族、符号链接是否健康。

主要能力:渲染仪表盘,包含标题、agent 目标表及其 serves 图例、技能族名册、漂移与完整性摘要。运行时会比较被 gitignore 的 .apache-magpie.local.lock(每机器拉取)与已提交的 .apache-magpie.lock(项目锁定),不一致时提示漂移并建议 setup upgrade,该提示不阻塞运行。

使用方式:默认无参数时渲染仪表盘并交互式提供调整;--no-adjust 仅渲染;adjust 直接进入重配置流程。收集器标志 --repo <path> 检查其他仓库,--format md 为默认 Markdown 仪表盘,--format json 输出原始字段(可加 --pretty)。运行命令为 python3 <framework>/skills/setup-status/scripts/collect_status.py。前置条件:git 检出(git rev-parse --show-toplevel 成功)或显式 --repo,PATH 中有 python3,无第三方包、无网络访问。

限制:本技能自身只读,任何变更都委托给 setup,绝不自行编辑符号链接、锁文件或 .gitignore;每次调整都需用户明确确认。若 .apache-magpie.lock 缺失则仓库未采用,应指向 setup 并停止。深度完整性、权限卫生、comdev-MCP 前置条件与陈旧工作树清理应使用 setup verify,本技能不重复实现。不得编造状态,只报告收集器观察到的内容;未知字段(如需要网络的上游 tip 漂移)应说明未检查并指出负责检查的技能。输出契约要求逐字呈现脚本的 Markdown 输出,不得重绘表格、删除 serves 图例、加回 Reads 列或重新计算结论。