---

name: Servei_Server 問題解決 description: Servei_Serverプロジェクト内の問題を診断・解決するためのスキル

Servei_Server 問題解決スキル

概要

このスキルは、Servei_Serverプロジェクト内の問題を診断し解決するためのガイドラインを提供します。

プロジェクト情報

• 場所: c:\Tools\Scripts\Servei_Server
• 種類: Google Apps Script (GAS) + サーバー管理スクリプト
• 主要ファイル:
  • api.js - API機能
  • main.js - メインエントリーポイント
  • config.js - 設定ファイル
  • linux-tasks/ - Linuxサーバー用スクリプト
  • windows-tasks/ - Windowsサーバー用スクリプト

📊 必須リソース

🔑 SSH接続情報

---

⚠️ Git操作前の重要事項

[!CAUTION] Git操作（commit, push, pull等）を行う前に、必ずGoogle Driveを停止してください！

Google Driveの同期が有効な状態でGit操作を行うと、ファイルの競合や.gitディレクトリの破損が発生する可能性があります。

停止方法

1. システムトレイのGoogle Driveアイコンを右クリック
2. 設定（歯車アイコン）→「同期を一時停止」を選択
3. Git操作完了後、忘れずに同期を再開してください

---

問題解決の手順

ステップ1: 問題の特定

ユーザーに以下を確認してください：

1. どのような問題が発生していますか？

   • エラーメッセージ
   • 期待される動作と実際の動作
   • いつから発生しているか

2. 問題が発生しているコンポーネントは？

   • GAS関連（api.js, main.js, config.js）
   • Linuxスクリプト（linux-tasks/）
   • Windowsスクリプト（windows-tasks/）
   • 設定・デプロイ（.clasp.json, appsscript.json）

ステップ2: 問題タイプ別対処

GASデプロイ問題

Copy# 現在のデプロイ状態確認
clasp status
clasp deployments

# 再デプロイ
clasp push
clasp deploy --description "修正デプロイ"

設定関連問題

1. config.jsを確認
2. APIトークン、URLの有効性を検証
3. スプレッドシートIDの確認

スクリプトエラー

1. ログを確認
2. 依存関係をチェック
3. 権限設定を確認

ステップ3: 修正とテスト

1. 問題を修正
2. ローカルでテスト可能な場合はテスト
3. GASの場合はclasp pushでデプロイ

ステップ4: Git操作

[!WARNING] 必ずGoogle Driveを停止してから実行！

Copygit status
git add .
git commit -m "問題を修正: [問題の説明]"
git push

---

追加スキルの作成

新しいスキルを追加するには、以下のディレクトリにSKILL.mdファイルを作成してください：

Copy.agent/skills/[スキル名]/SKILL.md

スキルファイルのテンプレート

Copy---
name: スキル名
description: スキルの説明
---

# スキル名

## 概要
[スキルの目的と用途]

## 使用方法
[具体的な手順]

## 関連ファイル
[このスキルが対象とするファイル/ディレクトリ]

---

利用可能なサブスキル

現在インストールされているサブスキルはありません。 必要に応じて templates/ ディレクトリから新しいスキルを追加できます。

---

トラブルシューティング参考

• gsession_restore_procedure.md - GASセッション復元手順