用途：这是 Mushi Mushi 的调试指南，用于按顺序诊断 SDK 未上报、边缘函数错误、API 密钥问题、故事映射失败、QA 故事失败、库存缺失和 PDCA 未触发等故障。
主要能力与用法：
- 检查 SDK 连接：运行 mushi doctor，若 MUSHI_API_KEY 失败则重新执行 mushi login。
- 检查边缘函数错误：通过 Sentry MCP 执行 get_sentry_issues project=mushi-be，关注 story-mapper、test-gen-from-story、pdca-runner、inventory-propose。
- 故事映射失败：在控制台 Inventory → Discovery → Recent crawls 查看失败运行的 error_message；常见原因包括缺少 Firecrawl API 密钥、URL 需认证、Claude 配额耗尽。
- TDD 测试生成失败：用 mushi tdd pending 检查故事是否在已接受库存中；若密钥耗尽，用 mushi keys list 后添加备用密钥。
- QA 故事未运行：检查 pending_review 状态并用 mushi tdd approve <id> 批准，或在控制台启用。
- API 密钥配额：mushi keys list 查看 quota_exhausted，用 mushi keys add --provider anthropic --key sk-ant-... --label "backup2" --priority 200 添加备用密钥。
- 库存不显示：通过 Supabase MCP 查询 inventory_proposals 与 inventories 表。
- PDCA 未触发：检查 cron.job 注册、故事 source 与 automation_mode，可手动执行 mushi tdd improve。
- 边缘函数日志：用 Supabase MCP 的 get_logs 或 supabase functions logs 查看。
限制：资料未提供产品定价、平台支持范围或效果保证；部分命令与数据库查询需按实际项目 ID 替换。若出现 relation does not exist，需在 packages/server 下执行 supabase db push --db-url postgresql://... 或按顺序应用迁移文件。