chatbot-dev

ChatBotプロジェクトの开発全般を支持するスキル。プロジェクト构造、コーディング规则约、开発ワークfurーに关する知识を提供します。ChatBoプロジェクトで作业する时、プロジェクト构造について质问された时、コーディng规约について质问された时、新しい机能を追加する时に使用してください。

📖 中文导读:ChatBotプロジェクトの开発全般を支持するスキル。プロジェクト构造、コーディング规则约、开発ワークfurーに关する知识を提供します。ChatBoプロジェクトで作业する时、プロジェクト构造について质问された时、コーディng规约について质问された时、新しい机能を追加する时に使用してください。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: chatbot-dev description: ChatBotプロジェクトの開発全般を支援するスキル。プロジェクト構造、コーディング規約、開発ワークフローに関する知識を提供します。ChatBotプロジェクトで作業する時、プロジェクト構造について質問された時、コーディング規約について質問された時、新しい機能を追加する時に使用してください。

ChatBot 開発スキル

このスキルはChatBotプロジェクトの開発全般を支援します。

プロジェクト概要

  • フロントエンド: HTML5/CSS3/JavaScript (ES6+)
  • バックエンド: Node.js + Express (app/server/index.js)
  • AI API: OpenAI, Claude, Gemini, Azure OpenAI対応
  • コード実行: JavaScript, Python (Pyodide), C++ (g++/JSCPP), HTML
  • ポート: 50000(デフォルト)

主要ディレクトリ

パス 説明
app/public/js/core/ コアモジュール(API、config、storage等)
app/public/js/components/ UIコンポーネント
app/public/js/modals/ モーダルダイアログ
app/public/js/utils/ ユーティリティ関数
app/public/css/ スタイルシート
app/server/ バックエンドサーバー

クラス設計パターン

シングルトンパターン(必須)

すべてのクラスはシングルトンパターンで実装:

class ClassName {
    static #instance = null;

    constructor() {
        if (ClassName.#instance) {
            return ClassName.#instance;
        }
        ClassName.#instance = this;
    }

    static get getInstance() {
        if (!ClassName.#instance) {
            ClassName.#instance = new ClassName();
        }
        return ClassName.#instance;
    }
}

プライベートメソッド

ES2022のプライベートフィールド/メソッドを使用:

#privateField = null;
#privateMethod() { /* ... */ }

設定管理

すべての設定値は window.CONFIG オブジェクトで管理:

window.CONFIG.AIAPI.ENDPOINTS.OPENAI  // APIエンドポイント
window.CONFIG.STORAGE.KEYS.API_TYPE   // ストレージキー
window.CONFIG.AIAPI.DEFAULT_PARAMS    // デフォルトパラメータ

開発手順

  1. 関連するコアファイルを確認
  2. 既存パターンに従って実装
  3. 適切なエラーハンドリングを追加
  4. JSDocコメントで型情報を記載

参照ファイル

詳細は以下のファイルを参照:

  • references/project-structure.md: 詳細なディレクトリ構成
  • references/coding-conventions.md: 命名規則、JSDoc
  • references/development-workflow.md: 開発フロー