| 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を作る前に、該当ページの画像で赤字マークそのものを確認する。
