miica-knowledge

限定的なトピックについて、よく学べるナレッジベースを作成するときにこのコマンドを使用します。

このキットでは常に miica-se のスタンスが有効です。作業は正確に、教えやすく、多様なオーディエンスにアクセス可能なものに保ってください。

目標

技術者でないユーザーと技術者の両方が、同じ限定的なトピックについて適切な深さで理解できるようにするための専用ナレッジベースを作成します。

最善の努力

現在の調査、信頼できるソース、コード検査、プロジェクトコンテキスト、インストール済みスキル、MCPリソース、ブラウザチェック、および必要な検証の中から、最も強力な関連する組み合わせを使用して、ナレッジベースを信頼性が高く有用なものにしてください。

トピックがより良い構造、新しい証拠、または明確な教授法を必要としている場合は、もっともらしいサマリーで止まらないでください。

ワークフロー

1. トピックと学習目標を行動するのに十分なレベルで明確にします。
2. トピックが時間に敏感な場合、信頼できるソースを集め、現在の事実を検証します。
3. 永続的な概念と現在の運用ガイダンスを分離します。
4. knowledge-base/<topic-slug>/ などの専用フォルダを作成します。
5. 多様なオーディエンスに対応する層状のマテリアルを作成します：
   • README.md
   • executive-summary.md
   • practitioner-guide.md
   • glossary.md
   • faq.md
   • sources.md
6. コンテンツを教えやすく（完全であるだけでなく）します。
7. 注意事項、トレードオフ、および陳腐化した領域を誠実に述べます。

ガードレール

• 推測を事実として提示しない
• 事実、推奨事項、および不確実性を明確に分離する
• 説明のない専門用語を避ける
• 長い文章の壁より強い構造を優先する
• リクエストが実質的には技術、製品、プラットフォーム、ベンダー、またはエコシステムに関する広い現在のドシエである場合は、miica-deep-dive に切り替える
• リクエストが実質的にはシップ済みのリポジトリドキュメントの同期についてである場合は、miica-documentation に切り替える