SuperAPI AI 工具集

mushi-health

部署与运维

查看项目

更新于 10-16 06:22

技能介绍

用途:对 Mushi Mushi 流水线的每个组件做通过/失败式健康检查,按顺序执行,遇到第一个 ❌ 就停下修复再继续。

主要能力与检查项:1) CLI 凭据,运行 mushi doctor,输出以 OK/WARN/FAIL 标记,退出码 0 全通过、2 仅警告、1 硬失败,FAIL 后附 → Fix 提示,mushi doctor --json 的 hint 字段含同样提示;失败可重跑 mushi login --api-key mushi_... --endpoint https://<ref>.supabase.co/functions/v1/api --project-id <pid>。2) API 与边缘函数,运行 mushi deploy check,对 api、classify-report、fix-worker、story-mapper、test-gen-from-story、pdca-runner、qa-story-runner 逐个轻量 ping,✗ 表示该函数不可用。3) 项目概览,运行 mushi status,确认报告数非零、autofix_agent 为预期代理、无 quota_exceeded 计费警告。4) BYOK 密钥池,用 mushi keys list 或 MCP list_byok_keys(projectId),健康标准是至少一个 anthropic 与一个 firecrawl 密钥 status=active;缺失可用 mushi keys add 添加。5) Supabase 日志,用 Supabase MCP get_logs(service: 'api') 查最近 15 分钟 ERROR,关注 story-mapper、test-gen-from-story、pdca-runner、qa-story-runner;未接入 MCP 时用 supabase functions logs <name> --project-ref <ref>。6) QA 定时任务,查询 qa_story_runs 近 2 小时状态分组,确认有 completed 行;为空时检查 story 的 enabled 与 approval_status、cron.job 中 qa% 任务,并可 mushi tdd run <qa-story-id> 手动触发。

使用方式:按上述六步顺序执行,最后用通过/失败汇总表记录各组件状态;全部 ✅ 表示流水线健康,任一 ❌ 可用 mushi-debug 做针对性诊断。

限制与常见问题:Supabase MCP 需在 MCP 配置中提供 SUPABASE_ACCESS_TOKEN;端点不可达多为 MUSHI_API_ENDPOINT 配置错误;全部边缘函数失败可能是 Supabase 免费项目被暂停;密钥全部 quota_exhausted 需为各提供商添加备用密钥;QA cron 不触发可能是 pg_cron 任务缺失,需重跑迁移 20260602000003_pdca_qa_improve_cron.sql。