Agent Skill
2/7/2026

havsan-appsscript

HAVSAN bünyesindeki Google Apps Script projeleri için ana rehber. Dockerize Clasp kullanımı, dağıtım güvenlik kontrolleri ve ortam izolasyonu sağlar. `.gs`, `appsscript.json` veya "Apps Script" / "Clasp" geçtiğinde kullanılır.

A
atifertugrul
0GitHub Stars
1Views
npx skills add atifertugrul-kan/havsan-ai-coding-mimari-app

SKILL.md

Namehavsan-appsscript
DescriptionHAVSAN bünyesindeki Google Apps Script projeleri için ana rehber. Dockerize Clasp kullanımı, dağıtım güvenlik kontrolleri ve ortam izolasyonu sağlar. `.gs`, `appsscript.json` veya "Apps Script" / "Clasp" geçtiğinde kullanılır.

version: 3.1.6 name: havsan-appsscript description: HAVSAN bünyesindeki Google Apps Script projeleri için ana rehber. Dockerize Clasp kullanımı, dağıtım güvenlik kontrolleri ve ortam izolasyonu sağlar. .gs, appsscript.json veya "Apps Script" / "Clasp" geçtiğinde kullanılır.

📜 HAVSAN Apps Script Uzmanlığı

Bu beceri, Google Apps Script projelerinde Docker tabanlı geliştirme ve Güvenli Dağıtım standartlarını sağlar.

🚨 1. DOCKER-FIRST KURALI (Anayasa)

HAVSAN ortamında yerel (local) Node.js kurulumu yoktur. Apps Script projeleri Docker içinde çalışır.

Yasaklı ve Doğru Komutlar

Yanlış (YASAK)Doğru (ZORUNLU)
clasp pushdocker compose exec -T app npx clasp push
clasp logindocker compose exec app npx clasp login --no-localhost
npm installdocker compose exec app npm install

Neden: Kullanıcı bilgisayarında node.exe aramamalıyız. Her şey konteyner içinde döner.

🛡️ 2. GÜVENLİK VE ONAY MEKANİZMASI

Canlıyı Koru (Push Safety)

clasp push komutu canlıdaki kodu değiştirdiği için kritik bir işlemdir.

  • Kural: Kullanıcı net bir şekilde "Deploy et", "Yükle" veya "Pushla" demeden ASLA bu komutu kendi kendine çalıştırma.
  • Onay: Eğer emin değilsen "Canlıya göndermek (push) istiyor musunuz?" diye sor.

🏗️ 3. PROJE YAPISI

Standart bir Apps Script projesi şu yapıda olmalıdır:

  • src/ -> Kodlar (.gs, .html, appsscript.json) burada durur.
  • docker-compose.yml -> Node.js ortamını ayağa kaldırır.
  • .clasp.json -> Proje bağlantı ayarları.

🧩 Sık Karşılaşılan Sorunlar

  1. "Invalid Grant" Hatası: Token ölmüştür. Çözüm: clasp login (Docker içinden!).
  2. "Node.exe not found": Yanlışlıkla yerel komut kullandın. Docker'a dön.
Skills Info
Original Name:havsan-appsscriptAuthor:atifertugrul