| name | kb-troubleshooting |
| description | エラー・不具合が起きたときの最初の参照先。AWS/LLMアプリ/Claude Code/AgentCore/フロントエンド/クラウド/外部MCP別にどのナレッジスキルを呼ぶべきかをルーティングする |
| user-invocable | true |
| model | sonnet |
トラブルシューティング集
カテゴリ別に分割されています。該当するスキルを参照してください:
トラブル発生領域別
| スキル | 内容 |
|---|
/kb-ts-aws | AWS全般(Cognito、Bedrock、Amplify、CDK、CloudWatch、AWS Agent Toolkit / uvx系接続エラー等) |
/kb-ts-llm-app | LLMアプリ(ストリーミング処理、Tavily、エクスポート) |
/kb-ts-claude-code | Claude Code設定(permissions、CLAUDE.md、settings.json) |
AWS公式プラグイン(agent-toolkit-for-aws)の Skills
トラブル内容によっては以下が自動起動するので任せてOK:
| 領域 | 自動起動するSkill |
|---|
| CDK / CloudFormation エラー | aws-core:aws-cdk / aws-core:aws-cloudformation |
| Lambda / API Gateway / Step Functions | aws-core:aws-serverless |
| CloudWatch / X-Ray / 監視周り | aws-core:aws-observability |
| ECS / Fargate / ECR | aws-core:aws-containers |
| Amplify Gen2 | aws-core:aws-amplify |
| IAM / STS | aws-core:aws-iam |
| Bedrock / Knowledge Base / Guardrail | aws-core:amazon-bedrock |
| AgentCore Runtime デプロイ失敗 | aws-agents:agents-deploy |
| AgentCore エージェント挙動異常 | aws-agents:agents-debug |
| AgentCore Gateway / 外部API連携 | aws-agents:agents-connect |
| AgentCore 本番ハーデニング | aws-agents:agents-harden |
| AgentCore 評価 / 監視 / コスト | aws-agents:agents-optimize |
みのるん固有のナレッジ(ハマりポイント、CDKコード例等)は引き続き /kb-agentcore-cdk 等の自作 kb- skill を使う*。両者は補完関係。
技術・プロダクト別
AgentCore
/kb-agentcore-cdk — CDK・ランタイム統合、Browser Tool、Dockerfile
/kb-agentcore-identity — Identity(3LO/M2M、OAuth)
/kb-agentcore-observability — OpenTelemetry、ログ、トレース
フロントエンド
/kb-frontend — React / Tailwind / モバイルUI 全般
/kb-frontend-sse — SSEストリーミング
/kb-frontend-amplify-ui — Amplify UI React(Authenticator等)
/kb-web-audio — Web Audio API / 音声対話UI
クラウド・インフラ
/kb-amplify-cdk — Amplify Gen2 + CDK
/kb-ec2-ssm — EC2 + SSM Session Manager
/kb-google-cloud — GCP / Vertex AI / ADK
エージェント系フレームワーク
/kb-strands-agentcore — Strands Agents
/kb-bidi-agent — BidiAgent / Nova Sonic
/kb-kimi — Kimi K2(Moonshot AI)
SaaS・外部サービス連携
/kb-line — LINE Bot
/kb-google-workspace-mcp — Google Workspace MCP
ツール・運用
/kb-marp — Marp(スライド生成)
/kb-aws-diagrams — AWS Diagram MCP Server
/kb-1password-cli — 1Password CLI(op)
PDF赤字読み取り
- PDF注釈のコメント・座標・矢印だけで削除範囲を断定しない。取り消し線、下線、囲みなどPDF上の実マークを拡大確認し、赤字対象が1文字だけなのか語句全体なのかを必ず切り分ける。
- 特に「☆削除」の注釈は、コメント位置の近くにある文全体ではなく、取り消し線が引かれた読点や助詞などの1文字だけを指すことがある。Before/Afterを作る前に、該当ページの画像で赤字マークそのものを確認する。